JavaTM 2 Platform
Standard Ed. 5.0

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.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, firePropertyChange, firePropertyChange, firePropertyChange, 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, 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()
戻り値:
このコンポーネントで使用されるバッファ方式
導入されたバージョン:
1.4
関連項目:
createBufferStrategy(int)

getAccessibleContext

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

定義:
インタフェース Accessible 内の getAccessibleContext
オーバーライド:
クラス Component 内の getAccessibleContext
戻り値:
この Canvas の AccessibleContext として機能する AccessibleAWTCanvas

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。