Canvas (Java Platform SE 8)

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

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスCanvas

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

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

フィールドのサマリー

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

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

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

メソッドのサマリー

クラス java.awt.Componentから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

Canvas

Canvas

メソッドの詳細

addNotify

paint

update

createBufferStrategy

createBufferStrategy

getBufferStrategy

getAccessibleContext