java.awt
クラス Canvas

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Canvas

すべての実装インタフェース:

Accessible, ImageObserver, MenuContainer, Serializable

public class Canvas

extends Component

implements Accessible

Canvas コンポーネントは、アプリケーションが描画したり、ユーザからの入力イベントをトラップしたりすることができる空白の矩形の画面領域を表します。

カスタムコンポーネント生成などの便利な機能を使うためには、アプリケーションで Canvas クラスをサブクラス化する必要があります。キャンバスでカスタムグラフィックスを実行するためには、paint メソッドをオーバーライドする必要があります。

導入されたバージョン:

JDK1.0

関連項目:

直列化された形式

入れ子クラスの概要

protected class

Canvas.AccessibleAWTCanvas このクラスは Canvas クラス用のユーザ補助機能のサポートを実装しています。

クラス java.awt.Component から継承した入れ子クラス

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()
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, getAlignmentX, getAlignmentY, getBackground, 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, 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, isOpaque, 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, setName, 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()

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

オーバーライド:

クラス Component 内の addNotify

関連項目:

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

paint

public void paint(Graphics g)

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

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

オーバーライド:

クラス Component 内の paint

パラメータ:

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

関連項目:

update(Graphics), Component.paint(Graphics)

update

public void update(Graphics g)

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

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

オーバーライド:

クラス Component 内の update

パラメータ:

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

関連項目:

paint(Graphics), Component.update(Graphics)

createBufferStrategy

public void createBufferStrategy(int numBuffers)

このコンポーネントの複数バッファについての方針を新しく生成します。複数バッファは描画のパフォーマンス向上に有効です。このメソッドではバッファ数について最適な方針を生成し、常にそのバッファ数を使用して BufferStrategy を登録します。最初にページ切り替えを試み、次に高速化されたバッファを使った Blit を試みます。どちらも使用できない場合は高速化されていない Blit が使用されます。

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

オーバーライド:

クラス Component 内の createBufferStrategy

パラメータ:

numBuffers - 生成するバッファ数。フロントバッファを含む

例外:

IllegalArgumentException - numBuffers が 1 より小さい場合

IllegalStateException - コンポーネントが表示できない場合

導入されたバージョン:

1.4

関連項目:

Component.isDisplayable(), getBufferStrategy()

createBufferStrategy

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

このコンポーネントに対する複数バッファ方針を、要求されたバッファ機能を使って新しく生成します。これは、たとえば高速化されたメモリまたはページ切り替えがバッファ機能で指定され、要求される場合だけに有効です。

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

オーバーライド:

クラス Component 内の createBufferStrategy

パラメータ:

numBuffers - 生成するバッファ数

caps - バッファ方針登録で要求されている機能。null は指定不可

例外:

AWTException - 提供されている機能がサポートされない、または条件に合わない場合。たとえば利用可能な高速化メモリが不足している場合、またはページ切り替えが指定されているが実行できない場合

IllegalArgumentException - numBuffers が 1 より小さい場合、または caps が null の場合

導入されたバージョン:

1.4

関連項目:

getBufferStrategy()

getBufferStrategy

public BufferStrategy getBufferStrategy()

オーバーライド:

クラス Component 内の getBufferStrategy

戻り値:

このコンポーネントで使用されるバッファ方針

導入されたバージョン:

1.4

関連項目:

createBufferStrategy(int)

getAccessibleContext

public AccessibleContext getAccessibleContext()

この Canvas に関連した AccessibleContext を返します。Canvas の場合、AccessibleContext は AccessibleAWTCanvas の形式を取ります。必要に応じて新規の AccessibleAWTCanvas インスタンスが作成されます。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Component 内の getAccessibleContext

戻り値:

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