Canvas

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.awt
类 Canvas

java.lang.Object
  java.awt.Component
      java.awt.Canvas

所有已实现的接口：: ImageObserver, MenuContainer, Serializable, Accessible

public class Canvas
extends Component
implements Accessible

Canvas 组件表示屏幕上一个空白矩形区域，应用程序可以在该区域内绘图，或者可以从该区域捕获用户的输入事件。

应用程序必须为 Canvas 类创建子类，以获得有用的功能（如创建自定义组件）。必须重写 paint 方法，以便在 canvas 上执行自定义图形。

从以下版本开始：: JDK1.0
另请参见：: 序列化表格

嵌套类摘要
`protected class`	`Canvas.AccessibleAWTCanvas` 此类实现对 `Canvas` 类的可访问性支持。

从类 java.awt.Component 继承的嵌套类/接口
`Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy`

字段摘要

从类 java.awt.Component 继承的字段
`BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT`

从接口 java.awt.image.ImageObserver 继承的字段
`ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH`

构造方法摘要
`Canvas()` 构造一个新的 Canvas。
`Canvas(GraphicsConfiguration config)` 根据给定 GraphicsConfiguration 对象构造一个新的 Canvas。

方法摘要
`void`	`addNotify()` 创建 canvas 的同位体。
`void`	`createBufferStrategy(int numBuffers)` 创建一个新的策略，用于对此组件的多次缓冲。
`void`	`createBufferStrategy(int numBuffers, BufferCapabilities caps)` 创建一个新的策略，使用所需的缓冲区能力对此组件进行多次缓冲。
`AccessibleContext`	`getAccessibleContext()` 获取与此 Canvas 相关的 AccessibleContext。
`BufferStrategy`	`getBufferStrategy()` 返回由此组件使用的 `BufferStrategy`。
`void`	`paint(Graphics g)` 绘制此 canvas。
`void`	`update(Graphics g)` 更新此 canvas。

从类 java.awt.Component 继承的方法
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, validate

从类 java.awt.Component 继承的方法

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, validate

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

构造方法详细信息

public Canvas()

构造一个新的 Canvas。

Canvas

public Canvas(GraphicsConfiguration config)

根据给定 GraphicsConfiguration 对象构造一个新的 Canvas。

参数：: config - 对 GraphicsConfiguration 对象的引用。
另请参见：: GraphicsConfiguration

方法详细信息

addNotify

public void addNotify()

创建 canvas 的同位体。此同位体允许您更改 canvas 的用户界面，而不更改其功能。

覆盖：: 类 Component 中的 addNotify

另请参见：: Toolkit.createCanvas(java.awt.Canvas), Component.getToolkit()

paint

public void paint(Graphics g)

绘制此 canvas。

为 Canvas 创建子类的大多数应用程序应该重写此方法，以便执行某个有用的操作（通常是 canvas 的自定义绘制操作）。默认操作是清理 canvas。重写此方法的应用程序不需要调用 super.paint(g)。

覆盖：: 类 Component 中的 paint

参数：: g - 指定的 Graphics 上下文
另请参见：: update(Graphics), Component.paint(Graphics)

update

public void update(Graphics g)

更新此 canvas。

调用此方法响应对 repaint 的调用。首先通过使用背景色填充 canvas 来清理它，然后通过调用此 canvas 的 paint 方法重绘它。注：重写此方法的应用程序应该调用 super.update(g)，或者将上述功能合并到其自身的代码中。

覆盖：: 类 Component 中的 update

参数：: g - 指定的 Graphics 上下文
另请参见：: paint(Graphics), Component.update(Graphics)

createBufferStrategy

public void createBufferStrategy(int numBuffers)

创建一个新的策略，用于对此组件的多次缓冲。多次缓冲对于提高呈现性能很有用。此方法试图使用提供的缓冲区数创建最佳可用策略。它始终创建一个使用该数量缓冲区的 BufferStrategy。首先尝试页面翻转策略，然后尝试使用加速缓冲区的位图传输策略。最后，使用非加速的位图传输策略。

每次调用此方法时，都会丢弃此组件现有的缓冲区策略。

参数：: numBuffers - 要创建的缓冲区数，包括前台缓冲区
抛出：: IllegalArgumentException - 如果 numBuffers 小于 1。; IllegalStateException - 如果组件不是可显示的

从以下版本开始：

1.4

另请参见：

Component.isDisplayable(), getBufferStrategy()

createBufferStrategy

public void createBufferStrategy(int numBuffers,
                                 BufferCapabilities caps)
                          throws AWTException

创建一个新的策略，使用所需的缓冲区能力对此组件进行多次缓冲。例如，如果只需加速内存或页面翻转（由缓冲区能力指定），则这种策略很有用。

每次调用此方法时，都会丢弃此组件现有的缓冲区策略。

参数：: numBuffers - 要创建的缓冲区数量; caps - 创建缓冲区策略所要求的能力；不能为 null

抛出：

AWTException - 如果提供的能力不受支持或不能满足要求；例如，如果当前可用的加速内存不够，或者不能进行指定的页面翻转时，可能出现这种情况。

IllegalArgumentException - 如果 numBuffers 小于 1，或者 caps 为 null

从以下版本开始：

1.4

另请参见：

getBufferStrategy()

getBufferStrategy

public BufferStrategy getBufferStrategy()

返回由此组件使用的 BufferStrategy。如果尚未创建 BufferStrategy 或者已经用完了内存，则此方法返回 null。

返回：: 此组件使用的缓冲区策略
从以下版本开始：: 1.4
另请参见：: createBufferStrategy(int)

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此 Canvas 相关的 AccessibleContext。对于 canvas 来说，AccessibleContext 采用 AccessibleAWTCanvas 的形式。如果必要，创建一个新的 AccessibleAWTCanvas 实例。

指定者：: 接口 Accessible 中的 getAccessibleContext
覆盖：: 类 Component 中的 getAccessibleContext

返回：: 一个 AccessibleAWTCanvas，它充当此 Canvas 的 AccessibleContext
从以下版本开始：: 1.3

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

java.awt 类 Canvas

Canvas

Canvas

addNotify

paint

update

createBufferStrategy

createBufferStrategy

getBufferStrategy

getAccessibleContext

java.awt
类 Canvas