public class java.awt
Canvas


Show All Login
Java SE 6
  
Extends: Component
Implements: Accessible
Inner classes: Canvas.AccessibleAWTCanvas
Details
A Canvas component represents a blank rectangular area of the screen onto which the application can draw or from which the application can trap input events from the user.

An application must subclass the Canvas class in order to get useful functionality such as creating a custom component. The paint method must be overridden in order to perform custom graphics on the canvas.
version1.39 04/07/06
sinceJDK1.0


Constructors
public Canvas()
Constructs a new Canvas.
public Canvas(GraphicsConfiguration config) Details
Constructs a new Canvas given a GraphicsConfiguration object.
configa reference to a GraphicsConfiguration object.
See also java.awt.GraphicsConfiguration

Methods
public void addNotify() Details
Creates the peer of the canvas. This peer allows you to change the user interface of the canvas without changing its functionality.
See also createCanvas(java.awt.Canvas), getToolkit()
public void createBufferStrategy(int numBuffers) Details
Creates a new strategy for multi-buffering on this component. Multi-buffering is useful for rendering performance. This method attempts to create the best strategy available with the number of buffers supplied. It will always create a BufferStrategy with that number of buffers. A page-flipping strategy is attempted first, then a blitting strategy using accelerated buffers. Finally, an unaccelerated blitting strategy is used.

Each time this method is called, the existing buffer strategy for this component is discarded.
numBuffersnumber of buffers to create, including the front buffer
ThrowsIllegalArgumentException: if numBuffers is less than 1.
ThrowsIllegalStateException: if the component is not displayable
since1.4
See also isDisplayable, getBufferStrategy

public void createBufferStrategy(int numBuffers, BufferCapabilities caps) throws AWTException Details
Creates a new strategy for multi-buffering on this component with the required buffer capabilities. This is useful, for example, if only accelerated memory or page flipping is desired (as specified by the buffer capabilities).

Each time this method is called, the existing buffer strategy for this component is discarded.
numBuffersnumber of buffers to create
capsthe required capabilities for creating the buffer strategy; cannot be null
ThrowsAWTException: if the capabilities supplied could not be supported or met; this may happen, for example, if there is not enough accelerated memory currently available, or if page flipping is specified but not possible.
ThrowsIllegalArgumentException: if numBuffers is less than 1, or if caps is null
since1.4
See also getBufferStrategy

public void paint(Graphics g) Details
Paints this canvas.

Most applications that subclass Canvas should override this method in order to perform some useful operation (typically, custom painting of the canvas). The default operation is simply to clear the canvas. Applications that override this method need not call super.paint(g).
gthe specified Graphics context
See also update(Graphics), paint(Graphics)

public void update(Graphics g) Details
Updates this canvas.

This method is called in response to a call to repaint. The canvas is first cleared by filling it with the background color, and then completely redrawn by calling this canvas's paint method. Note: applications that override this method should either call super.update(g) or incorporate the functionality described above into their own code.
gthe specified Graphics context
See also paint(Graphics), update(Graphics)


Properties
public AccessibleContext getAccessibleContext() Details
Gets the AccessibleContext associated with this Canvas. For canvases, the AccessibleContext takes the form of an AccessibleAWTCanvas. A new AccessibleAWTCanvas instance is created if necessary.
returnan AccessibleAWTCanvas that serves as the AccessibleContext of this Canvas
since1.3
public BufferStrategy getBufferStrategy() Details
Returns the BufferStrategy used by this component. This method will return null if a BufferStrategy has not yet been created or has been disposed.
returnthe buffer strategy used by this component
since1.4
See also createBufferStrategy