Class Display

package javax.microedition.lcdui

java.lang.Object
  |
  +--javax.microedition.lcdui.Display

설명

extends Object:

Display는 시스템의 입력 장치 및 디스플레이 관리자를 나타냅니다. 여기에는 장치의 등록 정보를 검색하고 장치에 해당 객체를 표시할 것을 요청하는 메소드가 포함됩니다. 장치 속성을 다루는 다른 메소드는 주로 Canvas 객체와 함께 사용되므로 여기가 아닌 그 쪽에서 정의됩니다.

MIDlet마다 정확히 한 개의 Display 인스턴스가 있으며 응용 프로그램은 getDisplay() 메소드를 호출하여 해당 인스턴스에 대한 참조를 가져올 수 있습니다. 응용 프로그램은 실행 중에 언제든지 getDisplay() 메소드를 호출할 수 있습니다. getDisplay()에 대한 모든 호출로 반환되는 Display 객체는 이 기간 동안 동일한 상태로 있게 됩니다.

일반 응용 프로그램은 해당 MIDlet 메소드 호출에 대한 응답으로 다음 작업을 수행합니다.

• startApp - 응용 프로그램이 일시 중지 상태에서 활성 상태로 이동합니다. 응용 프로그램이 활성화되는 동안 필요한 객체를 초기화해야 합니다. 초기화가 이루어지지 않은 경우 응용 프로그램은 첫 화면에서 setCurrent()를 호출할 수 있습니다. 그 사이에 pauseApp()가 호출되는 경우 startApp()를 여러 번 호출할 수 있습니다. 이는 일회성 초기화가 발생해서는 안 되며 대신 MIDlet 구성자 내에서 발생해야 한다는 것을 의미합니다.
• pauseApp - 응용 프로그램이 자신의 스레드를 일시 중지합니다. 또한 응용 프로그램이 다시 활성화될 때 다른 화면에서 시작하려는 경우에는 setCurrent()를 사용하여 새 화면을 설정합니다.
• destroyApp - 응용 프로그램에서 자원을 사용 가능하게 만들고 스레드를 종료합니다. destroyApp()가 반환된 후 사용자 인터페이스 객체에 있는 메소드 호출에 대한 동작은 정의되지 않습니다.

디스플레이 장치에 표시된 사용자 인터페이스 객체는 Displayable 객체 내에 포함됩니다. 응용 프로그램은 언제든 디스플레이 장치에 표시되어 이를 통해 사용자 상호 작용이 가능한 Displayable 객체를 하나 정도 가질 수 있습니다. 이 Displayable을 현재 Displayable이라고 합니다.

Display 클래스에는 현재 Displayable을 설정하는 setCurrent() 메소드가 있으며 현재 Displayable을 검색하는 getCurrent() 메소드가 있습니다. 응용 프로그램은 현재 Displayable을 제어하며 언제든지 setCurrent()를 호출할 수 있습니다. 일반적으로 응용 프로그램은 일부 사용자 작업에 대한 응답으로 현재 Displayable을 변경합니다. 하지만 항상 그런 것은 아닙니다. 다른 스레드가 다른 자극에 대한 응답으로 현재 Displayable을 변경할 수 있습니다. Alert 타이머의 시간이 경과하면 현재 Displayable도 변경됩니다.

응용 프로그램의 현재 Displayable은 실제로 화면에 나타나지 않을 수 있으며 발생하는 사용자 이벤트(예: 키 입력)가 반드시 현재 Displayable로 지정되지 않을 수도 있습니다. 이는 같은 장치에서 동시에 다른 MIDlet 응용 프로그램이 실행되기 때문에 발생합니다.

현재 Displayable이 디스플레이 장치에 실제로 표시되고 사용자 입력 장치 이벤트가 이 장치에 전달되는 경우 응용 프로그램이 포그라운드에 있다고 말할 수 있습니다. 응용 프로그램이 포그라운드에 있지 않은 경우에는 디스플레이 장치와 입력 장치 모두에 액세스하기 어려우며 이 경우 백그라운드에 있다고 말할 수 있습니다. 이러한 장치를 다른 MIDlet 응용 프로그램에 할당하는 정책은 이 사양의 범위를 벗어나며 응용 프로그램 관리 소프트웨어라는 외부 에이전트의 제어를 받습니다.

위에 언급된 대로 응용 프로그램이 백그라운드에 있더라도 현재 Displayable의 개념은 여전히 가집니다. 현재 Displayable은 다음에 응용 프로그램을 포그라운드로 가져올 때 표시할 내용이므로 백그라운드 응용 프로그램인 경우에도 현재 Displayable은 중요합니다. 응용 프로그램은 isShown()을 호출하여 Displayable을 디스플레이에서 실제로 표시할지 결정할 수 있습니다. Canvas의 경우 Canvas를 표시하고 숨길 때 각각 showNotify()와 hideNotify() 메소드가 호출됩니다.

각 MIDlet 응용 프로그램은 고유한 현재 Displayable을 가집니다. 이는 MIDlet의 포그라운드/백그라운드 상태에 상관없이 getCurrent() 메소드가 MIDlet의 현재 Displayable을 반환한다는 것을 의미합니다. 예를 들어, 포그라운드에서 실행되는 MIDlet에 현재 Displayable F가 있고, 백그라운드에서 실행되는 MIDlet에 현재 Displayable B가 있다고 가정하는 경우, 포그라운드 MIDlet에서 getCurrent()를 호출하면 F를 반환하며 백그라운드 MIDlet에서 getCurrent()를 호출하면 B를 반환합니다. 그리고 MIDlet에서 setCurrent()를 호출하여 현재 Displayable을 변경하는 경우 다른 MIDlet의 현재 Displayable에 아무런 영향을 미치지 않습니다.

getCurrent()에서 null을 반환할 가능성이 있습니다. MIDlet 응용 프로그램이 첫 화면에서 setCurrent()를 호출하기 전에 시작하면 이러한 일이 발생할 수 있습니다. getCurrent() 메소드는 이전에 이 MIDlet에서 setCurrent()를 호출할 때 전달되지 않은 Displayable 객체에 대한 참조는 절대 반환하지 않습니다.

시스템 화면

일반적으로 포그라운드 MIDlet의 현재 화면은 디스플레이에 표시됩니다. 하지만 특정 상황에서 시스템은 응용 프로그램의 현재 화면을 일시적으로 흐리게 하는 화면을 만들 수 있습니다. 이러한 화면을 시스템 화면이라고 합니다. 이는 시스템이 명령 메뉴를 표시해야 하거나 시스템이 Form 내의 텍스트 필드 안이 아닌 별도의 화면에서 텍스트를 편집하도록 사용자에게 요구하는 경우에 발생합니다. 시스템 화면이 응용 프로그램 화면을 흐리게 하더라도 현재 화면의 개념은 변경되지 않습니다. 특히 시스템 화면이 표시되는 동안 getCurrent()에 대한 호출은 시스템 화면이 아닌 응용 프로그램의 현재 화면을 반환합니다. 시스템 화면으로 현재 Displayable이 희미해진 경우 isShown()이 반환하는 값은 false입니다.

시스템 화면이 캔버스를 흐리게 하면 hideNotify() 메소드가 호출됩니다. 시스템 화면이 제거되면 캔버스가 복구되면서 해당 showNotify() 메소드와 paint() 메소드가 호출됩니다. 명령을 실행할 사용자가 시스템 화면을 사용하는 경우 showNotify()가 호출된 다음 commandAction() 메소드가 호출됩니다.

이 클래스는 높은 수준 사용자 인터페이스의 일반적인 전경색 및 배경색을 검색하는 메소드를 포함합니다. 이러한 메소드는 다른 항목의 사용자 인터페이스와 일치하는 CustomItem 객체를 만들고 시스템 나머지 부분의 사용자 인터페이스와 일치하는 Canvas 내에서 사용자 인터페이스를 만들 때 유용합니다. 구현 시 사용자 인터페이스에서 전경색 및 배경색만 사용하도록 제한하지는 않지만(예: 비스듬하게 보이도록 강조 표시 및 그림자 색 사용) 반환되는 색은 해당 구현의 색 구성표와 상당히 일치하는 색입니다. 사용자 정의 항목을 구현하는 응용 프로그램은 배경색을 사용하여 해당 영역을 지운 다음 텍스트 및 기하 그래픽(선, 호, 직사각형)을 전경색으로 칠합니다.

Since:

• MIDP 1.0

필드 요약

• static int ALERT — Alert 이미지의 이미지 유형.
• static int CHOICE_GROUP_ELEMENT — ChoiceGroup 요소 이미지의 이미지 유형.
• static int COLOR_BACKGROUND — getColor 에서 사용할 색 지정자.
• static int COLOR_BORDER — getColor 에서 사용할 색 지정자.
• static int COLOR_FOREGROUND — getColor 에서 사용할 색 지정자.
• static int COLOR_HIGHLIGHTED_BACKGROUND — getColor 에서 사용할 색 지정자.
• static int COLOR_HIGHLIGHTED_BORDER — getColor 에서 사용할 색 지정자.
• static int COLOR_HIGHLIGHTED_FOREGROUND — getColor 에서 사용할 색 지정자.
• static int LIST_ELEMENT — List 요소 이미지의 이미지 유형.

메서드 요약

• void callSerially ( Runnable r) — Runnable 객체 r 이 해당 run() 메소드를 나중에 호출하여 다시 그리기 주기가 완료된 직후 해당 이벤트 스트림과 일련화되도록 합니다.
• boolean flashBacklight (int duration) — 장치의 후광으로 깜박임 효과를 요청합니다.
• int getBestImageHeight (int imageType) — 지정된 이미지 유형에 최적인 이미지 높이를 반환합니다.
• int getBestImageWidth (int imageType) — 지정된 이미지 유형에 최적인 이미지 너비를 반환합니다.
• int getBorderStyle (boolean highlighted) — 구성 요소의 상태(강조 표시된/강조 표시되지 않은)에 따라 경계선 그리기에 사용된 입력 스타일을 반환합니다.
• int getColor (int colorSpecifier) — 전달된 colorSpecifier 를 기반으로 한 0x00RRGGBB 형식으로 높은 수준의 사용자 인터페이스 색 구성표에서 색 하나를 반환합니다.
• Displayable getCurrent () — 이 MIDlet 의 현재 Displayable 객체를 가져옵니다.
• static Display getDisplay ( MIDlet m) — 이 MIDlet 에 고유한 Display 객체를 가져옵니다.
• boolean isColor () — 장치의 색 지원에 대한 정보를 가져옵니다.
• int numAlphaLevels () — 이 구현에서 지원하는 알파 투명도 수준의 수를 가져옵니다.
• int numColors () — 장치에서 표현할 수 있는 색의 수( isColor() 가 true 인 경우) 또는 회색 수준( isColor() 가 false 인 경우)을 가져옵니다.
• void setCurrent ( Alert alert, Displayable nextDisplayable) — 이 Alert 를 현재로 만들고, Alert 가 닫힌 후에는 nextDisplayable 을 현재로 만들 것을 요청합니다.
• void setCurrent ( Displayable nextDisplayable) — 다양한 Displayable 객체를 디스플레이에 표시하도록 요청합니다.
• void setCurrentItem ( Item item) — 이 Item 을 포함하는 Displayable 이 현재가 되고 Displayable 을 스크롤하여 Item 을 표시하고 여기에 해당 초점을 할당하도록 요청합니다.
• boolean vibrate (int duration) — 장치의 바이브레이터 작업을 요청합니다.

필드 상세

LIST_ELEMENT

public static final int LIST_ELEMENT

Since:

• MIDP 2.0

See Also:

• getBestImageWidth(int imageType), getBestImageHeight(int imageType), Constant Field Values

CHOICE_GROUP_ELEMENT

public static final int CHOICE_GROUP_ELEMENT

Since:

• MIDP 2.0

See Also:

• getBestImageWidth(int imageType), getBestImageHeight(int imageType), Constant Field Values

ALERT

public static final int ALERT

Since:

• MIDP 2.0

See Also:

• getBestImageWidth(int imageType), getBestImageHeight(int imageType), Constant Field Values

COLOR_BACKGROUND

public static final int COLOR_BACKGROUND

Since:

• MIDP 2.0

See Also:

• getColor(int), Constant Field Values

COLOR_FOREGROUND

public static final int COLOR_FOREGROUND

Since:

• MIDP 2.0

See Also:

• getColor(int), Constant Field Values

COLOR_HIGHLIGHTED_BACKGROUND

public static final int COLOR_HIGHLIGHTED_BACKGROUND

Since:

• MIDP 2.0

See Also:

• getColor(int), Constant Field Values

COLOR_HIGHLIGHTED_FOREGROUND

public static final int COLOR_HIGHLIGHTED_FOREGROUND

Since:

• MIDP 2.0

See Also:

• getColor(int), Constant Field Values

COLOR_BORDER

public static final int COLOR_BORDER

Since:

• MIDP 2.0

See Also:

• getColor(int), Constant Field Values

COLOR_HIGHLIGHTED_BORDER

public static final int COLOR_HIGHLIGHTED_BORDER

Since:

• MIDP 2.0

See Also:

• getColor(int), Constant Field Values

getDisplay

public static Display getDisplay(MIDlet m)

Parameters:

• m - 응용 프로그램의 MIDlet

Returns:

• 응용 프로그램이 사용자 인터페이스에 사용할 수 있는 디스플레이 객체

Throws:

• NullPointerException - m이 null인 경우

getColor

public int getColor(int colorSpecifier)

Parameters:

• colorSpecifier - 미리 정의된 색 지정자. COLOR_BACKGROUND, COLOR_FOREGROUND, COLOR_HIGHLIGHTED_BACKGROUND, COLOR_HIGHLIGHTED_FOREGROUND, COLOR_BORDER, COLOR_HIGHLIGHTED_BORDER 중 하나여야 합니다.

Returns:

• 0x00RRGGBB 형식의 색

Throws:

• IllegalArgumentException - colorSpecifier가 유효한 색 지정자가 아닌 경우

Since:

• MIDP 2.0

getBorderStyle

public int getBorderStyle(boolean highlighted)

Parameters:

• highlighted - 요청된 경계선 스타일이 강조 표시된 상태용이면 true, 요청된 경계선 스타일이 강조 표시되지 않은 상태용이면 false

Returns:

• Graphics.DOTTED 또는 Graphics.SOLID

Since:

• MIDP 2.0

isColor

public boolean isColor()

Returns:

• 디스플레이에서 색을 지원하면 true, 그렇지 않으면 false

numColors

public int numColors()

Returns:

• 색의 수

numAlphaLevels

public int numAlphaLevels()

Returns:

• 지원되는 알파 수준 수

Since:

• MIDP 2.0

getCurrent

public Displayable getCurrent()

Returns:

• MIDlet의 현재 Displayable 객체

See Also:

• setCurrent(javax.microedition.lcdui.Displayable)

setCurrent

public void setCurrent(Displayable nextDisplayable)

Parameters:

• nextDisplayable - 현재로 만들기 위해 요청된 Displayable로 null이 허용됩니다.

See Also:

• getCurrent()

setCurrent

public void setCurrent(Alert alert,
                       Displayable nextDisplayable)

Parameters:

• nextDisplayable - 이 경고가 닫힌 다음 표시될 Displayable

Throws:

• IllegalArgumentException - nextDisplayable이 Alert인 경우

See Also:

• Alert, getCurrent()

setCurrentItem

public void setCurrentItem(Item item)

Parameters:

• item - 표시되어야 하는 항목

Throws:

• NullPointerException - item이 null인 경우

Since:

• MIDP 2.0

callSerially

public void callSerially(Runnable r)

Parameters:

• r - 호출되는 Runnable 인터페이스의 인스턴스

flashBacklight

public boolean flashBacklight(int duration)

Parameters:

• duration - 후광이 깜박여야 할 시간(밀리초), 또는 깜박임이 중지되어야 하는 경우 0

Returns:

• 응용 프로그램에서 후광을 제어할 수 있고 이 디스플레이가 포그라운드에 있는 경우 true, 그렇지 않은 경우 false

Throws:

• IllegalArgumentException - duration이 음수인 경우

Since:

• MIDP 2.0

vibrate

public boolean vibrate(int duration)

Parameters:

• duration - 바이브레이터를 실행해야 하는 시간(밀리초), 또는 바이브레이터를 해제해야 하는 경우 0

Returns:

• 응용 프로그램에서 바이브레이터를 제어할 수 있고 이 디스플레이가 포그라운드에 있는 경우 true, 그렇지 않은 경우 false

Throws:

• IllegalArgumentException - duration이 음수인 경우

Since:

• MIDP 2.0

getBestImageWidth

public int getBestImageWidth(int imageType)

Parameters:

• imageType - 이미지 유형

Returns:

• 이미지 유형에 최적인 이미지 너비로 최적의 크기가 없는 경우 0일 수 있으며 음수가 아니어야 합니다.

Throws:

• IllegalArgumentException - imageType이 유효하지 않은 경우

Since:

• MIDP 2.0

getBestImageHeight

public int getBestImageHeight(int imageType)

Parameters:

• imageType - 이미지 유형

Returns:

• 이미지 유형에 최적인 이미지 높이로 최적의 크기가 없는 경우 0일 수 있으며 음수가 아니어야 합니다.

Throws:

• IllegalArgumentException - imageType이 유효하지 않은 경우

Since:

• MIDP 2.0

메서드 상세

getDisplay

public static Display getDisplay(MIDlet m)

Parameters:

• m - 응용 프로그램의 MIDlet

Returns:

• 응용 프로그램이 사용자 인터페이스에 사용할 수 있는 디스플레이 객체

Throws:

• NullPointerException - m이 null인 경우

getColor

public int getColor(int colorSpecifier)

Parameters:

• colorSpecifier - 미리 정의된 색 지정자. COLOR_BACKGROUND, COLOR_FOREGROUND, COLOR_HIGHLIGHTED_BACKGROUND, COLOR_HIGHLIGHTED_FOREGROUND, COLOR_BORDER, COLOR_HIGHLIGHTED_BORDER 중 하나여야 합니다.

Returns:

• 0x00RRGGBB 형식의 색

Throws:

• IllegalArgumentException - colorSpecifier가 유효한 색 지정자가 아닌 경우

Since:

• MIDP 2.0

getBorderStyle

public int getBorderStyle(boolean highlighted)

Parameters:

• highlighted - 요청된 경계선 스타일이 강조 표시된 상태용이면 true, 요청된 경계선 스타일이 강조 표시되지 않은 상태용이면 false

Returns:

• Graphics.DOTTED 또는 Graphics.SOLID

Since:

• MIDP 2.0

isColor

public boolean isColor()

Returns:

• 디스플레이에서 색을 지원하면 true, 그렇지 않으면 false

numColors

public int numColors()

Returns:

• 색의 수

numAlphaLevels

public int numAlphaLevels()

Returns:

• 지원되는 알파 수준 수

Since:

• MIDP 2.0

getCurrent

public Displayable getCurrent()

Returns:

• MIDlet의 현재 Displayable 객체

See Also:

• setCurrent(javax.microedition.lcdui.Displayable)

setCurrent

public void setCurrent(Displayable nextDisplayable)

Parameters:

• nextDisplayable - 현재로 만들기 위해 요청된 Displayable로 null이 허용됩니다.

See Also:

• getCurrent()

setCurrent

public void setCurrent(Alert alert,
                       Displayable nextDisplayable)

Parameters:

• nextDisplayable - 이 경고가 닫힌 다음 표시될 Displayable

Throws:

• IllegalArgumentException - nextDisplayable이 Alert인 경우

See Also:

• Alert, getCurrent()

setCurrentItem

public void setCurrentItem(Item item)

Parameters:

• item - 표시되어야 하는 항목

Throws:

• NullPointerException - item이 null인 경우

Since:

• MIDP 2.0

callSerially

public void callSerially(Runnable r)

Parameters:

• r - 호출되는 Runnable 인터페이스의 인스턴스

flashBacklight

public boolean flashBacklight(int duration)

Parameters:

• duration - 후광이 깜박여야 할 시간(밀리초), 또는 깜박임이 중지되어야 하는 경우 0

Returns:

• 응용 프로그램에서 후광을 제어할 수 있고 이 디스플레이가 포그라운드에 있는 경우 true, 그렇지 않은 경우 false

Throws:

• IllegalArgumentException - duration이 음수인 경우

Since:

• MIDP 2.0

vibrate

public boolean vibrate(int duration)

Parameters:

• duration - 바이브레이터를 실행해야 하는 시간(밀리초), 또는 바이브레이터를 해제해야 하는 경우 0

Returns:

• 응용 프로그램에서 바이브레이터를 제어할 수 있고 이 디스플레이가 포그라운드에 있는 경우 true, 그렇지 않은 경우 false

Throws:

• IllegalArgumentException - duration이 음수인 경우

Since:

• MIDP 2.0

getBestImageWidth

public int getBestImageWidth(int imageType)

Parameters:

• imageType - 이미지 유형

Returns:

• 이미지 유형에 최적인 이미지 너비로 최적의 크기가 없는 경우 0일 수 있으며 음수가 아니어야 합니다.

Throws:

• IllegalArgumentException - imageType이 유효하지 않은 경우

Since:

• MIDP 2.0

getBestImageHeight

public int getBestImageHeight(int imageType)

Parameters:

• imageType - 이미지 유형

Returns:

• 이미지 유형에 최적인 이미지 높이로 최적의 크기가 없는 경우 0일 수 있으며 음수가 아니어야 합니다.

Throws:

• IllegalArgumentException - imageType이 유효하지 않은 경우

Since:

• MIDP 2.0