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, 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()

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

オーバーライド:

クラス 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 方式が試行されます。

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

パラメータ:

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 より小さい場合、 またはキャップが 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

戻り値:

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

導入されたバージョン:

1.3