Canvas (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

## 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

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.