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 から継承されたフィールド

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