Class Canvas

package javax.microedition.lcdui

java.lang.Object
  |
  +--javax.microedition.lcdui.Displayable
        |
        +--javax.microedition.lcdui.Canvas

설명

Direct Known Subclasses:

• GameCanvas

extends Displayable:

Canvas 클래스는 낮은 수준의 이벤트를 처리하고 디스플레이로 이동하기 위한 그래픽을 호출해야 하는 응용 프로그램을 작성하기 위한 기본 클래스입니다. 대체로 게임 응용 프로그램에서 Canvas 클래스를 많이 사용합니다. 응용 프로그램 개발 면에서 보자면 Canvas 클래스는 표준 Screen 클래스와 바꾸어 사용할 수 있으므로 응용 프로그램은 필요한 경우 높은 수준 화면과 Canvas를 혼합하여 일치시킬 수 있습니다. 예를 들어, List 화면은 레이싱 게임 추적을 선택하는 데 사용되며 Canvas 서브 클래스는 실제 게임을 구현합니다.

Canvas는 개발자에게 게임 동작, 키 이벤트 및 포인터 이벤트(장치에서 지원하는 경우)를 처리하는 메소드를 제공합니다. 또한 장치의 기능 및 게임 작업에 대한 키 매핑을 식별하기 위한 메소드가 제공됩니다. 키 이벤트는 키 코드에 관하여 보고되며, 키 코드는 장치의 실제 키에 직접 바운드되므로 키 코드를 사용하면 이식 가능성이 줄어듭니다. 이식 가능 응용 프로그램은 키 코드 대신 게임 작업을 사용해야 합니다.

Displayable의 다른 서브 클래스와 마찬가지로 Canvas 클래스를 사용하면 응용 프로그램은 명령의 수신기를 등록할 수 있습니다. 하지만 다른 Displayables와는 달리 Canvas 클래스에서는 응용 프로그램이 해당 클래스를 분류하여 사용해야 합니다. paint() 메소드는 abstract로 선언되므로 응용 프로그램은 해당 서브 클래스 내에 반드시 구현을 제공해야 합니다. 다른 이벤트 보고 메소드는 abstract로 선언되지 않으므로 기본 구현은 비어 있습니다(즉, 아무 작업도 하지 않음). 따라서 응용 프로그램은 관심 있는 이벤트를 보고하는 메소드만 무시할 수 있습니다.

이 클래스는 응용 프로그램이 수신기를 정의하고 Screen 클래스의 인스턴스를 사용하여 이를 등록할 수 있도록 허용하는 Screen 클래스와는 대조적입니다. 전달되어야 하는 각 이벤트 종류별로 하나씩 여러 개의 새 수신기 인터페이스를 만들어야 하기 때문에 이 스타일은 Canvas 클래스에 사용되지 않습니다. 보다 적은 수신기 인터페이스를 갖도록 하는 것이 대안이 될 수는 있지만, 이 경우 수신기는 관심이 없는 이벤트를 필터링해야 합니다.

키 이벤트

응용 프로그램은 키 코드의 공간 내에서 개별 키의 이름이 지정된 키입력 이벤트를 받습니다. MIDP 응용 프로그램에 이벤트를 보고하는 각 키에는 키 코드가 할당됩니다. 두 키가 서로에 대해 정확히 동일한 기능을 하지 않는 이상 키 코드 값은 각 하드웨어 키에 고유합니다. MIDP에는 KEY_NUM0, KEY_NUM1, KEY_NUM2, KEY_NUM3, KEY_NUM4, KEY_NUM5, KEY_NUM6, KEY_NUM7, KEY_NUM8, KEY_NUM9, KEY_STAR 및 KEY_POUND와 같은 키 코드가 정의되어 있습니다.

이러한 키 코드는 ITU-T 표준 전화 키패드의 키에 해당합니다. 다른 키가 키보드에 있을 수 있으며 일반적으로 위의 목록과 구별되는 키 코드를 가집니다. 이식 가능성을 보장하려면 응용 프로그램에서 해당 표준 키 코드만 사용해야 합니다.

표준 키 코드 값은 키를 나타내는 문자의 유니코드 인코딩과 같습니다. 장치에 유니코드 문자와 정확하게 일치하는 다른 키가 포함되어 있는 경우 이러한 키 코드 값은 해당 문자의 유니코드 인코딩과 같아야 합니다. 일치하는 유니코드 문자가 없는 키의 경우 구현 시 음수 값을 사용해야 합니다. 0은 잘못된 키 코드로 정의됩니다. 다음 코드를 사용하여 응용 프로그램에서 키 코드를 유니코드로 변환할 수 있습니다.

if (keyCode > 0) { char ch = (char)keyCode; // … }

이 기술은 제한된 특정 경우에만 유용합니다. 특히 대문자와 소문자, 키보드 shift 키 상태, 두 개 이상의 키입력을 요구하는 문자를 처리하지 않기 때문에 전체 텍스트 입력에 충분하지 않습니다. 텍스트 입력을 위해서 응용 프로그램은 항상 TextBox 또는 TextField 객체를 사용해야 합니다.

때로 이 키에 대한 메시지를 표시하기 위해 키의 이름을 찾는 것이 유용한 경우도 있습니다. 이 경우 응용 프로그램은 getKeyName() 메소드를 사용하여 키 이름을 찾을 수 있습니다.

게임 작업

화살표 키 이벤트와 게임 관련 이벤트가 필요한 이식 가능 응용 프로그램은 키 코드와 키 이름보다는 게임 작업을 사용해야 합니다. MIDP에는 UP, DOWN, LEFT, RIGHT, FIRE, GAME_A, GAME_B, GAME_C 및 GAME_D와 같은 게임 작업이 정의됩니다.

각 키 코드는 기껏해야 하나의 게임 작업에 매핑될 수 있습니다. 하지만 게임 작업은 두 개 이상의 키 코드와 연관됩니다. 응용 프로그램은 getGameAction(int keyCode) 메소드를 사용하여 키 코드를 게임 작업으로 변환할 수 있으며 getKeyCode(int gameAction) 메소드를 사용하여 게임 작업을 키 코드로 변환할 수 있습니다. 특정 게임 작업과 연관된 키 코드는 여러 개 있을 수 있지만 getKeyCode는 이러한 키 코드 중 하나만 반환합니다. g가 유효한 게임 작업이고 k가 게임 작업과 연관된 키에 대해 유효한 키 코드인 경우 다음 표현식을 고려합니다.

g == getGameAction(getKeyCode(g)) // (1) k == getKeyCode(getGameAction(k)) // (2)

표현식 (1)은 항상 true입니다. 하지만 표현식 (2)는 true일 수도 있지만 반드시 true인 것은 아닙니다.

구현 시에는 응용 프로그램 실행 도중 게임 작업 및 키 코드의 매핑을 변경할 수 없습니다.

게임 작업을 사용하려는 이식 가능 응용 프로그램은 getGameAction() 메소드를 호출한 다음 결과를 테스트하여 각 키 이벤트를 게임 작업으로 변환해야 합니다. 예를 들어, 일부 장치에서 게임 작업 UP, DOWN, LEFT 및 RIGHT는 네 방향의 이동 화살표 키에 매핑됩니다. 이 경우 getKeyCode(UP)는 위쪽 화살표 키에 대해 장치 종속 코드를 반환합니다. 다른 장치의 경우 가능한 매핑은 번호 키 2, 4, 6 및 8에 있습니다. 이 경우 getKeyCode(UP)는 KEY_NUM2를 반환합니다. 두 경우 모두 사용자가 장치에서 “실제로 왼쪽에 있는” 키를 누르면 getGameAction() 메소드는 LEFT 게임 작업을 반환합니다.

명령

또한 현재 캔버스를 사용 중인 경우 사용자는 commands를 실행할 수 있습니다. Commands는 장치별 고유 방식으로 키와 메뉴에 매핑됩니다. 일부 장치의 경우 명령에 사용된 키는 키 코드 이벤트를 캔버스에 전달할 키와 중복됩니다. 이 경우 장치는 이러한 키가 명령이나 키 코드 이벤트를 응용 프로그램에 전달할 것인지 여부를 결정하는 모드를 사용자가 선택하도록 허용하는 응용 프로그램에 투명한 수단을 제공합니다. Canvas가 표준 모드에 있는 경우(아래 참조), 캔버스에 사용 가능한 일련의 키 코드 이벤트는 현재의 명령 개수나 명령 수신기의 존재에 따라 변경되지 않습니다. Canvas가 전체 화면 모드에 있으며 명령 수신기가 없는 경우 장치는 명령 전달을 위해 예약될 수도 있는 키에 대한 키 코드 이벤트 전달을 선택합니다. 게임 개발자는 명령에 대한 액세스가 장치별로 크게 달라지며 게임 도중 사용자에게 명령 실행을 요구하면 실행 가능한 게임의 용이성에 큰 영향을 미칠 수 있음을 알아야 합니다.

이벤트 전달

Canvas 객체는 구현 시 호출되는 여러 메소드를 정의합니다. 이러한 메소드는 대개 응용 프로그램에 이벤트를 전달하는 것이 목적이므로 이를 이벤트 전달 메소드라고 합니다. 일련의 메소드는 다음과 같습니다.

• showNotify()
• hideNotify()
• keyPressed()
• keyRepeated()
• keyReleased()
• pointerPressed()
• pointerDragged()
• pointerReleased()
• paint()

이러한 메소드는 연속적으로 모두 호출됩니다. 즉, 구현 시 이벤트 전달 메소드 중 하나에 대한 이전 호출이 반환되어야 이벤트 전달 메소드를 호출할 수 있습니다. serviceRepaints() 메소드는 paint()가 호출되어 반환될 때까지 차단되므로 이 규칙에 대한 예외가 됩니다. 이러한 예외는 이벤트 전달 메소드 중 하나에 있는 해당 응용 프로그램에서 serviceRepaints()를 호출하는 경우에도 발생합니다.

Display.callSerially() 메소드는 이벤트 스트림을 사용하여 일부 응용 프로그램 정의 작업을 일련화하는 데 사용할 수 있습니다. 자세한 내용은 패키지 요약의 이벤트 처리 및 동시 처리 절을 참조하십시오.

키 관련, 포인터 관련 및 paint() 메소드는 Canvas가 출력 장치에 실제로 표시되는 동안만 호출됩니다. 그러므로 이러한 메소드는 showNotify()에 대한 호출 이후 및 hideNotify()에 대한 호출 이전에 이 Canvas 객체에서만 호출됩니다. hideNotify()가 호출된 다음에는 showNotify()에 대한 후속 호출이 반환될 때까지 키, 포인터 및 paint 메소드 중 어느 것도 호출되지 않습니다. callSerially()에서 발생하는 run() 메소드에 대한 호출은 showNotify() 및 hideNotify()에 대한 호출과 상관없이 발생합니다.

showNotify() 메소드는 Canvas가 실제로 디스플레이에 표시되기 전에 호출되며 hideNotify() 메소드는 Canvas가 디스플레이에서 제거된 다음 호출됩니다. Canvas의 표시 상태(또는 다른 Displayable 객체)는 Displayable.isShown() 메소드를 사용하여 쿼리할 수 있습니다. Canvas의 표시 상태는 포그라운드와 백그라운드 상태 사이에서 MIDlet을 이동하는 응용 프로그램 관리 소프트웨어에 의해 또는 시스템 화면을 사용하여 Canvas를 흐리게 만드는 시스템에 의해 변경됩니다. 따라서 showNotify() 및 hideNotify()에 대한 호출은 MIDlet의 제어를 받지 않으므로 상당히 자주 발생할 수 있습니다. 응용 프로그램 개발자가 경량을 최소로 유지하려면 비용이 많이 드는 설치 및 분해 작업은 showNotify()와 hideNotify() 메소드 밖에서 수행하는 것이 좋습니다.

Canvas는 표준 모드나 전체 화면 모드에 있을 수 있습니다. 표준 모드에서 디스플레이의 공간은 명령 레이블, 제목 및 티커가 차지할 수 있습니다. Canvas를 전체 화면 모드로 설정하면 응용 프로그램은 Canvas가 디스플레이 공간을 가능한 한 많이 차지하도록 요청합니다. 전체 화면 모드에서는 제목 및 티커가 Canvas에 있더라도 표시되지 않으며 Commands는 몇 가지 대체 수단(팝업 메뉴를 통하는 등)을 사용하여 표시됩니다. 표시된 Canvas가 전체 화면 모드에 있더라도 구현 시에는 상태 표시기 등에 디스플레이의 일부분을 할애합니다. 전체 화면 모드에서 제목은 표시되지 않더라도 해당 텍스트는 Commands의 팝업 메뉴 제목 등 다른 용도로 계속 사용될 수 있습니다.

Canvas 객체는 기본적으로 표준 모드에 있습니다. 표준 대 전체 화면 모드 설정은 setFullScreenMode(boolean) 메소드 사용을 통해 제어됩니다.

setFullScreenMode(boolean)를 호출하면 sizeChanged()가 호출될 수 있습니다. 이 메소드의 기본 구현은 어떤 작업도 하지 않습니다. 응용 프로그램은 사용 가능한 그리기 영역 크기에서 변경 내용을 처리하기 위해 이 메소드를 무시할 수 있습니다.

주: 개요의 “사양 요구 사항” 절에서 언급한 대로 구현 시 사용자에게 네트워크 사용에 대한 표시를 제공해야 합니다. 표시기가 화면에 제공되는 경우에는 Canvas가 전체 화면 모드에 있어도 네트워크 활동이 발생하면 표시되어야 합니다.

Since:

• MIDP 1.0

필드 요약

• static int DOWN — DOWN 게임 작업의 상수.
• static int FIRE — FIRE 게임 작업의 상수.
• static int GAME_A — 일반 용도 ” A ” 게임 작업의 상수.
• static int GAME_B — 일반 용도 ” B ” 게임 작업의 상수.
• static int GAME_C — 일반 용도 ” C ” 게임 작업의 상수.
• static int GAME_D — 일반 용도 ” D ” 게임 작업의 상수.
• static int KEY_NUM0 — ITU-T 키 0 의 키 코드.
• static int KEY_NUM1 — ITU-T 키 1 의 키 코드.
• static int KEY_NUM2 — ITU-T 키 2 의 키 코드.
• static int KEY_NUM3 — ITU-T 키 3 의 키 코드.
• static int KEY_NUM4 — ITU-T 키 4 의 키 코드.
• static int KEY_NUM5 — ITU-T 키 5 의 키 코드.
• static int KEY_NUM6 — ITU-T 키 6 의 키 코드.
• static int KEY_NUM7 — ITU-T 키 7 의 키 코드.
• static int KEY_NUM8 — ITU-T 키 8 의 키 코드.
• static int KEY_NUM9 — ITU-T 키 9 의 키 코드.
• static int KEY_POUND — ITU-T 키 “파운드”( # )의 키 코드.
• static int KEY_STAR — ITU-T 키 “스타”( * )의 키 코드.
• static int LEFT — LEFT 게임 작업의 상수.
• static int RIGHT — RIGHT 게임 작업의 상수.
• static int UP — UP 게임 작업의 상수.

생성자 요약

• protected Canvas () — 새 Canvas 객체를 구성합니다.

메서드 요약

• int getGameAction (int keyCode) — 장치의 지정된 키 코드와 연관된 게임 작업을 가져옵니다.
• int getHeight () — Canvas 의 디스플레이 가능 영역의 높이를 픽셀 단위로 가져옵니다.
• int getKeyCode (int gameAction) — 장치에 지정된 게임 작업에 해당하는 키 코드를 가져옵니다.
• String getKeyName (int keyCode) — 키에 대한 정보가 들어 있는 키 문자열을 가져옵니다.
• int getWidth () — Canvas 의 디스플레이 가능 영역의 너비를 픽셀 단위로 가져옵니다.
• boolean hasPointerEvents () — 플랫폼이 포인터 누르기 및 놓기 이벤트를 지원하는지 검사합니다.
• boolean hasPointerMotionEvents () — 플랫폼이 포인터 모션 이벤트(포인터 끌기)를 지원하는지 검사합니다.
• boolean hasRepeatEvents () — 키를 누른 채로 있을 때 플랫폼에서 반복 이벤트를 생성할 수 있는지 검사합니다.
• protected  void hideNotify () — 구현 시 Canvas 가 디스플레이에서 제거된 다음 바로 hideNotify() 를 호출합니다.
• boolean isDoubleBuffered () — 구현 시 Canvas 가 이중 버퍼되었는지 검사합니다.
• protected  void keyPressed (int keyCode) — 키를 누르면 호출됩니다.
• protected  void keyReleased (int keyCode) — 키를 놓으면 호출됩니다.
• protected  void keyRepeated (int keyCode) — 키가 반복되면(누른 채로 있으면) 호출됩니다.
• protected abstract  void paint ( Graphics g) — Canvas 를 렌더링합니다.
• protected  void pointerDragged (int x, int y) — 포인터를 끌면 호출됩니다.
• protected  void pointerPressed (int x, int y) — 포인터를 누르면 호출됩니다.
• protected  void pointerReleased (int x, int y) — 포인터를 놓으면 호출됩니다.
• void repaint () — 전체 Canvas 에 대해 다시 그리기를 요청합니다.
• void repaint (int x, int y, int width, int height) — Canvas 의 지정한 영역에 대해 다시 그리기를 요청합니다.
• void serviceRepaints () — 보류 중인 다시 그리기 요청이 즉시 처리되도록 합니다.
• void setFullScreenMode (boolean mode) — Canvas 를 전체 화면 모드에 둘지 표준 모드에 둘지 여부를 제어합니다.
• protected  void showNotify () — 구현 시 Canvas 가 디스플레이에 표시되기 전에 바로 showNotify() 를 호출합니다.
• protected  void sizeChanged (int w, int h) — Canvas 의 그리기 가능 영역이 변경되면 호출됩니다.

필드 상세

UP

public static final int UP

See Also:

• Constant Field Values

DOWN

public static final int DOWN

See Also:

• Constant Field Values

LEFT

public static final int LEFT

See Also:

• Constant Field Values

RIGHT

public static final int RIGHT

See Also:

• Constant Field Values

FIRE

public static final int FIRE

See Also:

• Constant Field Values

GAME_A

public static final int GAME_A

See Also:

• Constant Field Values

GAME_B

public static final int GAME_B

See Also:

• Constant Field Values

GAME_C

public static final int GAME_C

See Also:

• Constant Field Values

GAME_D

public static final int GAME_D

See Also:

• Constant Field Values

KEY_NUM0

public static final int KEY_NUM0

See Also:

• Constant Field Values

KEY_NUM1

public static final int KEY_NUM1

See Also:

• Constant Field Values

KEY_NUM2

public static final int KEY_NUM2

See Also:

• Constant Field Values

KEY_NUM3

public static final int KEY_NUM3

See Also:

• Constant Field Values

KEY_NUM4

public static final int KEY_NUM4

See Also:

• Constant Field Values

KEY_NUM5

public static final int KEY_NUM5

See Also:

• Constant Field Values

KEY_NUM6

public static final int KEY_NUM6

See Also:

• Constant Field Values

KEY_NUM7

public static final int KEY_NUM7

See Also:

• Constant Field Values

KEY_NUM8

public static final int KEY_NUM8

See Also:

• Constant Field Values

KEY_NUM9

public static final int KEY_NUM9

See Also:

• Constant Field Values

KEY_STAR

public static final int KEY_STAR

See Also:

• Constant Field Values

KEY_POUND

public static final int KEY_POUND

See Also:

• Constant Field Values

Canvas

protected Canvas()

• 새 Canvas 객체를 구성합니다.

getWidth

public int getWidth()

Overrides:

• getWidth in class Displayable

Returns:

• 디스플레이 가능 영역의 너비

getHeight

public int getHeight()

Overrides:

• getHeight in class Displayable

Returns:

• 디스플레이 가능 영역의 높이

isDoubleBuffered

public boolean isDoubleBuffered()

Returns:

• 이중 버퍼된 경우 true, 그렇지 않으면 false입니다.

hasPointerEvents

public boolean hasPointerEvents()

Returns:

• 장치에서 포인터 이벤트를 지원하는 경우 true입니다.

hasPointerMotionEvents

public boolean hasPointerMotionEvents()

Returns:

• 장치에서 포인터 모션 이벤트를 지원하는 경우 true입니다.

hasRepeatEvents

public boolean hasRepeatEvents()

Returns:

• 장치에서 반복 이벤트를 지원하는 경우 true입니다.

getKeyCode

public int getKeyCode(int gameAction)

Parameters:

• gameAction - 게임 작업

Returns:

• 이 게임 작업에 해당하는 키 코드

Throws:

• IllegalArgumentException - gameAction이 유효한 게임 작업이 아닌 경우

getKeyName

public String getKeyName(int keyCode)

Parameters:

• keyCode - 요청된 키 코드

Returns:

• 키의 문자열 이름

Throws:

• IllegalArgumentException - keyCode가 유효한 키 코드가 아닌 경우

getGameAction

public int getGameAction(int keyCode)

Parameters:

• keyCode - 키 코드

Returns:

• 이 키에 해당하는 게임 작업, 또는 해당 게임 작업이 없는 경우 0

Throws:

• IllegalArgumentException - keyCode가 유효한 키 코드가 아닌 경우

setFullScreenMode

public void setFullScreenMode(boolean mode)

Parameters:

• mode - Canvas가 전체 화면 모드에 있으면 true, 그렇지 않은 경우 false

Since:

• MIDP 2.0

keyPressed

protected void keyPressed(int keyCode)

Parameters:

• keyCode - 누른 키에 대한 키 코드

keyRepeated

protected void keyRepeated(int keyCode)

Parameters:

• keyCode - 반복된 키에 대한 키 코드

See Also:

• hasRepeatEvents()

keyReleased

protected void keyReleased(int keyCode)

Parameters:

• keyCode - 해제된 키에 대한 키 코드

pointerPressed

protected void pointerPressed(int x,
                              int y)

Parameters:

• y - 포인터를 누른 수직 위치(Canvas에 상대적)

pointerReleased

protected void pointerReleased(int x,
                               int y)

Parameters:

• y - 포인터를 놓은 수직 위치(Canvas에 상대적)

pointerDragged

protected void pointerDragged(int x,
                              int y)

Parameters:

• y - 포인터를 끈 수직 위치(Canvas에 상대적)

repaint

public final void repaint(int x,
                          int y,
                          int width,
                          int height)

Parameters:

• height - 다시 그릴 직사각형의 높이

See Also:

• Display.callSerially(Runnable), serviceRepaints()

repaint

public final void repaint()

전체 Canvas 에 대해 다시 그리기를 요청합니다. 결과는 다음과 같습니다. repaint(0, 0, getWidth(), getHeight());

serviceRepaints

public final void serviceRepaints()

See Also:

• Display.callSerially(Runnable)

showNotify

protected void showNotify()

구현 시 Canvas 가 디스플레이에 표시되기 전에 바로 showNotify() 를 호출합니다. Canvas 서브 클래스는 애니메이션 설정, 타이머 시작 등이 표시되기 전에 작업을 수행하기 위해 이 메소드를 무시할 수 있습니다. Canvas 클래스에 있는 이 메소드의 기본 구현은 비어 있습니다.

hideNotify

protected void hideNotify()

구현 시 Canvas 가 디스플레이에서 제거된 다음 바로 hideNotify() 를 호출합니다. Canvas 서브 클래스는 애니메이션 일시 중지, 타이머 해지 등의 작업을 수행하기 위해 이 메소드를 무시할 수 있습니다. Canvas 클래스에서 이 메소드의 기본 구현은 비어 있습니다.

paint

protected abstract void paint(Graphics g)

Parameters:

• g - Canvas 렌더링에 사용된 Graphics 객체

sizeChanged

protected void sizeChanged(int w,
                           int h)

Overrides:

• sizeChanged in class Displayable

Parameters:

• h - Canvas 그리기 가능 영역의 새 높이(픽셀 단위)

Since:

• MIDP 2.0

생성자 상세

Canvas

protected Canvas()

• 새 Canvas 객체를 구성합니다.

getWidth

public int getWidth()

Overrides:

• getWidth in class Displayable

Returns:

• 디스플레이 가능 영역의 너비

getHeight

public int getHeight()

Overrides:

• getHeight in class Displayable

Returns:

• 디스플레이 가능 영역의 높이

isDoubleBuffered

public boolean isDoubleBuffered()

Returns:

• 이중 버퍼된 경우 true, 그렇지 않으면 false입니다.

hasPointerEvents

public boolean hasPointerEvents()

Returns:

• 장치에서 포인터 이벤트를 지원하는 경우 true입니다.

hasPointerMotionEvents

public boolean hasPointerMotionEvents()

Returns:

• 장치에서 포인터 모션 이벤트를 지원하는 경우 true입니다.

hasRepeatEvents

public boolean hasRepeatEvents()

Returns:

• 장치에서 반복 이벤트를 지원하는 경우 true입니다.

getKeyCode

public int getKeyCode(int gameAction)

Parameters:

• gameAction - 게임 작업

Returns:

• 이 게임 작업에 해당하는 키 코드

Throws:

• IllegalArgumentException - gameAction이 유효한 게임 작업이 아닌 경우

getKeyName

public String getKeyName(int keyCode)

Parameters:

• keyCode - 요청된 키 코드

Returns:

• 키의 문자열 이름

Throws:

• IllegalArgumentException - keyCode가 유효한 키 코드가 아닌 경우

getGameAction

public int getGameAction(int keyCode)

Parameters:

• keyCode - 키 코드

Returns:

• 이 키에 해당하는 게임 작업, 또는 해당 게임 작업이 없는 경우 0

Throws:

• IllegalArgumentException - keyCode가 유효한 키 코드가 아닌 경우

setFullScreenMode

public void setFullScreenMode(boolean mode)

Parameters:

• mode - Canvas가 전체 화면 모드에 있으면 true, 그렇지 않은 경우 false

Since:

• MIDP 2.0

keyPressed

protected void keyPressed(int keyCode)

Parameters:

• keyCode - 누른 키에 대한 키 코드

keyRepeated

protected void keyRepeated(int keyCode)

Parameters:

• keyCode - 반복된 키에 대한 키 코드

See Also:

• hasRepeatEvents()

keyReleased

protected void keyReleased(int keyCode)

Parameters:

• keyCode - 해제된 키에 대한 키 코드

pointerPressed

protected void pointerPressed(int x,
                              int y)

Parameters:

• y - 포인터를 누른 수직 위치(Canvas에 상대적)

pointerReleased

protected void pointerReleased(int x,
                               int y)

Parameters:

• y - 포인터를 놓은 수직 위치(Canvas에 상대적)

pointerDragged

protected void pointerDragged(int x,
                              int y)

Parameters:

• y - 포인터를 끈 수직 위치(Canvas에 상대적)

repaint

public final void repaint(int x,
                          int y,
                          int width,
                          int height)

Parameters:

• height - 다시 그릴 직사각형의 높이

See Also:

• Display.callSerially(Runnable), serviceRepaints()

repaint

public final void repaint()

전체 Canvas 에 대해 다시 그리기를 요청합니다. 결과는 다음과 같습니다. repaint(0, 0, getWidth(), getHeight());

serviceRepaints

public final void serviceRepaints()

See Also:

• Display.callSerially(Runnable)

showNotify

protected void showNotify()

구현 시 Canvas 가 디스플레이에 표시되기 전에 바로 showNotify() 를 호출합니다. Canvas 서브 클래스는 애니메이션 설정, 타이머 시작 등이 표시되기 전에 작업을 수행하기 위해 이 메소드를 무시할 수 있습니다. Canvas 클래스에 있는 이 메소드의 기본 구현은 비어 있습니다.

hideNotify

protected void hideNotify()

구현 시 Canvas 가 디스플레이에서 제거된 다음 바로 hideNotify() 를 호출합니다. Canvas 서브 클래스는 애니메이션 일시 중지, 타이머 해지 등의 작업을 수행하기 위해 이 메소드를 무시할 수 있습니다. Canvas 클래스에서 이 메소드의 기본 구현은 비어 있습니다.

paint

protected abstract void paint(Graphics g)

Parameters:

• g - Canvas 렌더링에 사용된 Graphics 객체

sizeChanged

protected void sizeChanged(int w,
                           int h)

Overrides:

• sizeChanged in class Displayable

Parameters:

• h - Canvas 그리기 가능 영역의 새 높이(픽셀 단위)

Since:

• MIDP 2.0

메서드 상세

getWidth

public int getWidth()

Overrides:

• getWidth in class Displayable

Returns:

• 디스플레이 가능 영역의 너비

getHeight

public int getHeight()

Overrides:

• getHeight in class Displayable

Returns:

• 디스플레이 가능 영역의 높이

isDoubleBuffered

public boolean isDoubleBuffered()

Returns:

• 이중 버퍼된 경우 true, 그렇지 않으면 false입니다.

hasPointerEvents

public boolean hasPointerEvents()

Returns:

• 장치에서 포인터 이벤트를 지원하는 경우 true입니다.

hasPointerMotionEvents

public boolean hasPointerMotionEvents()

Returns:

• 장치에서 포인터 모션 이벤트를 지원하는 경우 true입니다.

hasRepeatEvents

public boolean hasRepeatEvents()

Returns:

• 장치에서 반복 이벤트를 지원하는 경우 true입니다.

getKeyCode

public int getKeyCode(int gameAction)

Parameters:

• gameAction - 게임 작업

Returns:

• 이 게임 작업에 해당하는 키 코드

Throws:

• IllegalArgumentException - gameAction이 유효한 게임 작업이 아닌 경우

getKeyName

public String getKeyName(int keyCode)

Parameters:

• keyCode - 요청된 키 코드

Returns:

• 키의 문자열 이름

Throws:

• IllegalArgumentException - keyCode가 유효한 키 코드가 아닌 경우

getGameAction

public int getGameAction(int keyCode)

Parameters:

• keyCode - 키 코드

Returns:

• 이 키에 해당하는 게임 작업, 또는 해당 게임 작업이 없는 경우 0

Throws:

• IllegalArgumentException - keyCode가 유효한 키 코드가 아닌 경우

setFullScreenMode

public void setFullScreenMode(boolean mode)

Parameters:

• mode - Canvas가 전체 화면 모드에 있으면 true, 그렇지 않은 경우 false

Since:

• MIDP 2.0

keyPressed

protected void keyPressed(int keyCode)

Parameters:

• keyCode - 누른 키에 대한 키 코드

keyRepeated

protected void keyRepeated(int keyCode)

Parameters:

• keyCode - 반복된 키에 대한 키 코드

See Also:

• hasRepeatEvents()

keyReleased

protected void keyReleased(int keyCode)

Parameters:

• keyCode - 해제된 키에 대한 키 코드

pointerPressed

protected void pointerPressed(int x,
                              int y)

Parameters:

• y - 포인터를 누른 수직 위치(Canvas에 상대적)

pointerReleased

protected void pointerReleased(int x,
                               int y)

Parameters:

• y - 포인터를 놓은 수직 위치(Canvas에 상대적)

pointerDragged

protected void pointerDragged(int x,
                              int y)

Parameters:

• y - 포인터를 끈 수직 위치(Canvas에 상대적)

repaint

public final void repaint(int x,
                          int y,
                          int width,
                          int height)

Parameters:

• height - 다시 그릴 직사각형의 높이

See Also:

• Display.callSerially(Runnable), serviceRepaints()

repaint

public final void repaint()

전체 Canvas 에 대해 다시 그리기를 요청합니다. 결과는 다음과 같습니다. repaint(0, 0, getWidth(), getHeight());

serviceRepaints

public final void serviceRepaints()

See Also:

• Display.callSerially(Runnable)

showNotify

protected void showNotify()

구현 시 Canvas 가 디스플레이에 표시되기 전에 바로 showNotify() 를 호출합니다. Canvas 서브 클래스는 애니메이션 설정, 타이머 시작 등이 표시되기 전에 작업을 수행하기 위해 이 메소드를 무시할 수 있습니다. Canvas 클래스에 있는 이 메소드의 기본 구현은 비어 있습니다.

hideNotify

protected void hideNotify()

구현 시 Canvas 가 디스플레이에서 제거된 다음 바로 hideNotify() 를 호출합니다. Canvas 서브 클래스는 애니메이션 일시 중지, 타이머 해지 등의 작업을 수행하기 위해 이 메소드를 무시할 수 있습니다. Canvas 클래스에서 이 메소드의 기본 구현은 비어 있습니다.

paint

protected abstract void paint(Graphics g)

Parameters:

• g - Canvas 렌더링에 사용된 Graphics 객체

sizeChanged

protected void sizeChanged(int w,
                           int h)

Overrides:

• sizeChanged in class Displayable

Parameters:

• h - Canvas 그리기 가능 영역의 새 높이(픽셀 단위)

Since:

• MIDP 2.0