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メソッドをオーバーライドする必要があります。

導入されたバージョン:

JDK1.0

関連項目:

直列化された形式

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
protected class	Canvas.AccessibleAWTCanvas このクラスはCanvasクラス用のアクセシビリティ・サポートを実装しています。

クラス java.awt.Componentから継承されたネストされたクラス/インタフェース

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドのサマリー

クラス java.awt.Componentから継承されたフィールド

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェース java.awt.image.ImageObserverから継承されたフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
Canvas() 新しいキャンバスを構築します。
Canvas(GraphicsConfiguration config) GraphicsConfigurationオブジェクトを指定して、新しいCanvasを構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
void	addNotify() キャンバスのピアを生成します。
void	createBufferStrategy(int numBuffers) このコンポーネントの新しいマルチバッファリング方法を作成します。
void	createBufferStrategy(int numBuffers, BufferCapabilities caps) 必要なバッファ機能を持つこのコンポーネントのマルチバッファリングの新しい方式を作成します。
AccessibleContext	getAccessibleContext() このCanvasに関連したAccessibleContextを取得します。
BufferStrategy	getBufferStrategy() このコンポーネントによって使用されるBufferStrategyを返します。
void	paint(Graphics g) このキャンバスをペイントします。
void	update(Graphics g) このキャンバスを更新します。

クラス 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, revalidate, 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

コンストラクタの詳細

Canvas

public Canvas()

新しいキャンバスを構築します。

Canvas

public Canvas(GraphicsConfiguration config)

GraphicsConfigurationオブジェクトを指定して、新しいCanvasを構築します。

パラメータ:

config - GraphicsConfigurationオブジェクトへの参照

関連項目:

GraphicsConfiguration

メソッドの詳細

addNotify

public void addNotify()

キャンバスのピアを生成します。このピアによって、キャンバスの機能を変更することなく、そのユーザー・インタフェースの変更が可能になります。

オーバーライド:

addNotify、クラス: Component

関連項目:

Toolkit.createCanvas(java.awt.Canvas), Component.getToolkit()

paint

public void paint(Graphics g)

このキャンバスをペイントします。

Canvasをサブクラス化するほとんどのアプリケーションでは、便利な操作を実行するためにこのメソッドをオーバーライドすることになります。キャンバスのカスタム・ペイントが典型的な例です。既定の操作は単純なキャンバスのクリアです。このメソッドをオーバーライドするアプリケーションでは、super.paint(g)を呼び出す必要はありません。

オーバーライド:

paint、クラス: Component

パラメータ:

g - 指定されたGraphicsコンテキスト

関連項目:

update(Graphics), Component.paint(Graphics)

update

public void update(Graphics g)

このキャンバスを更新します。

このメソッドはrepaintの呼出しに反応して呼び出されます。キャンバスは最初に背景色でクリアされ、このキャンバスのpaintメソッドを呼び出して完全に再描画されます。注: このメソッドをオーバーライドするアプリケーションはsuper.update(g)を呼び出すか、先に述べた機能をコードに追加してください。

オーバーライド:

update、クラス: Component

パラメータ:

g - 指定されたGraphicsコンテキスト

関連項目:

paint(Graphics), Component.update(Graphics)

createBufferStrategy

public void createBufferStrategy(int numBuffers)

このコンポーネントの新しいマルチバッファリング方法を作成します。マルチバッファリングは描画のパフォーマンスに有効です。このメソッドは、指定されたバッファ数で使用できる最善の方式を作成しようとします。常に、その数のバッファを使用してBufferStrategyを作成します。最初にページ反転方式が試行され、次に高速バッファを使ってBlit方式が試行されます。最後に、非高速Blit方式が試行されます。

このメソッドが呼び出されるごとに、このコンポーネントに対する既存のバッファ方式は破棄されます。

パラメータ:

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インスタンスが作成されます。

定義:

getAccessibleContext、インタフェース: Accessible

オーバーライド:

getAccessibleContext、クラス: Component

戻り値:

このCanvasのAccessibleContextとして機能するAccessibleAWTCanvas

導入されたバージョン:

1.3