java.awt
클래스 Canvas

java.lang.Object 
  java.awt.Component 
      java.awt.Canvas

모든 구현된 인터페이스:

ImageObserver , MenuContainer , Serializable , Accessible

public class Canvas
extends Component 
implements Accessible 

Canvas 컴퍼넌트는, 어플리케이션이 draw 하거나 사용자로부터의 입력 이벤트를 트랩 하거나 할 수가 있는 공백의 구형의 화면 영역을 나타냅니다.

커스텀 컴퍼넌트 생성등이 편리한 기능을 사용하기 위해서(때문에)는, 어플리케이션으로 Canvas 클래스를 서브 클래스화할 필요가 있습니다. 캔버스에서 커스텀 그래픽스를 실행하기 위해서는,paint 메소드를 오버라이드(override) 할 필요가 있습니다.

도입된 버젼:

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

캔버스의 피어를 생성합니다. 이 피어에 의해, 캔버스의 기능을 변경하는 일 없이, 그 사용자 인터페이스의 변경이 가능하게 됩니다.

오버라이드(override):

클래스 Component 내의 addNotify

관련 항목:

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

paint

public void paint(Graphics  g)

이 캔버스를 그립니다.

Canvas 를 서브 클래스화하는 대부분의 어플리케이션에서는, 편리한 조작을 실행하기 위해서 이 메소드를 오버라이드(override) 하게 됩니다. 캔버스의 커스텀 페인트가 전형적인 예입니다. 기정의 조작은 단순한 캔버스의 클리어입니다. 이 메소드를 오버라이드(override) 하는 어플리케이션에서는, super.paint(g)를 호출할 필요는 없습니다.

오버라이드(override):

클래스 Component 내의 paint

파라미터:

g - 지정된 Graphics 문맥

관련 항목:

update(Graphics) , Component.paint(Graphics)

update

public void update(Graphics  g)

이 캔버스를 갱신합니다.

이 메소드는 repaint 의 호출해에 반응해 불려 갑니다. 캔버스는 최초로 배경색으로 클리어 되어 이 캔버스의 paint 메소드를 호출해 완전하게 재draw 됩니다. 주:이 메소드를 오버라이드(override) 하는 어플리케이션은 super.update(g)를 호출하는지, 먼저 말한 기능을 코드에 추가해 주세요.

오버라이드(override):

클래스 Component 내의 update

파라미터:

g - 지정된 Graphics 문맥

관련 항목:

paint(Graphics) , Component.update(Graphics)

createBufferStrategy

public void createBufferStrategy(int numBuffers)

이 컴퍼넌트의 새로운 멀티 버퍼링 방법을 작성합니다. 멀티 버퍼링은 draw의 렌더링 퍼포먼스에 유효합니다. 이 메소드는, 제공된 버퍼수로 사용할 수 있는 최선의 방식을 작성하려고 합니다. 이것은 항상 그 버퍼수에 의한 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

오버라이드(override):

클래스 Component 내의 getAccessibleContext

반환값:

이 Canvas 의 AccessibleContext 로서 기능하는 AccessibleAWTCanvas

도입된 버젼:

1.3