javax.microedition.lcdui
Class Display

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

public class 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

Field Summary

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 요소 이미지의 이미지 유형.

Method Summary

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) 장치의 바이브레이터 작업을 요청합니다.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LIST_ELEMENT

public static final int LIST_ELEMENT

List 요소 이미지의 이미지 유형.

LIST_ELEMENT의 값은 1입니다.

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

ChoiceGroup 요소 이미지의 이미지 유형.

CHOICE_GROUP_ELEMENT의 값은 2입니다.

Since:

MIDP 2.0

See Also:

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

ALERT

public static final int ALERT

Alert 이미지의 이미지 유형.

ALERT의 값은 3입니다.

Since:

MIDP 2.0

See Also:

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

COLOR_BACKGROUND

public static final int COLOR_BACKGROUND

getColor에서 사용할 색 지정자. COLOR_BACKGROUND는 화면의 배경색을 지정합니다. 배경색은 항상 전경색과 대조됩니다.

COLOR_BACKGROUND의 값은 0입니다.

Since:

MIDP 2.0

See Also:

getColor(int), Constant Field Values

COLOR_FOREGROUND

public static final int COLOR_FOREGROUND

getColor에서 사용할 색 지정자. COLOR_FOREGROUND는 화면의 텍스트 문자 및 간단한 그래픽에 대해 전경색을 지정합니다. 정적 텍스트나 사용자 편집 가능 텍스트는 전경색으로 그려야 합니다. 전경색은 항상 배경색과 대조됩니다.

COLOR_FOREGROUND의 값은 1입니다.

Since:

MIDP 2.0

See Also:

getColor(int), Constant Field Values

COLOR_HIGHLIGHTED_BACKGROUND

public static final int COLOR_HIGHLIGHTED_BACKGROUND

getColor에서 사용할 색 지정자. COLOR_HIGHLIGHTED_BACKGROUND는 직사각형에 채워질 때 초점 강조 표시 색이나 초점의 색을 식별합니다. 강조 표시된 백그라운드는 항상 강조 표시된 포그라운드와 대조됩니다.

COLOR_HIGHLIGHTED_BACKGROUND의 값은 2입니다.

Since:

MIDP 2.0

See Also:

getColor(int), Constant Field Values

COLOR_HIGHLIGHTED_FOREGROUND

public static final int COLOR_HIGHLIGHTED_FOREGROUND

getColor에서 사용할 색 지정자. COLOR_HIGHLIGHTED_FOREGROUND는 텍스트 문자와 간단한 그래픽을 강조 표시할 때 이들의 색을 식별합니다. 강조 표시된 포그라운드는 강조 표시된 배경에 강조 표시된 텍스트와 그래픽을 그릴 때 사용되는 색입니다. 강조 표시된 포그라운드는 항상 강조 표시된 백그라운드와 대조됩니다.

COLOR_HIGHLIGHTED_FOREGROUND의 값은 3입니다.

Since:

MIDP 2.0

See Also:

getColor(int), Constant Field Values

COLOR_BORDER

public static final int COLOR_BORDER

getColor에서 사용할 색 지정자. COLOR_BORDER는 객체를 강조 표시되지 않은 상태로 그릴 때 상자와 경계선의 색을 식별합니다. 경계선 색은 배경색과 함께 사용되는 것으로 배경색과는 대조됩니다. 응용 프로그램은 getBorderStyle()에서 반환하는 입력 스타일을 사용하여 경계선을 그려야 합니다.

COLOR_BORDER의 값은 4입니다.

Since:

MIDP 2.0

See Also:

getColor(int), Constant Field Values

COLOR_HIGHLIGHTED_BORDER

public static final int COLOR_HIGHLIGHTED_BORDER

getColor에서 사용할 색 지정자. COLOR_HIGHLIGHTED_BORDER는 객체를 강조 표시된 상태로 그릴 때 상자와 경계선의 색을 식별합니다. 강조 표시된 경계선 색은 배경색(강조 표시된 배경색이 아닌)과 함께 사용되는 것으로 배경색과는 대조됩니다. 응용 프로그램은 getBorderStyle()에서 반환한 입력 스타일을 사용하여 경계선을 그려야 합니다.

COLOR_HIGHLIGHTED_BORDER의 값은 5입니다.

Since:

MIDP 2.0

See Also:

getColor(int), Constant Field Values

Method Detail

getDisplay

public static Display getDisplay(MIDlet m)

이 MIDlet에 고유한 Display 객체를 가져옵니다.

Parameters:

m - 응용 프로그램의 MIDlet

Returns:

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

Throws:

NullPointerException - m이 null인 경우

getColor

public int getColor(int colorSpecifier)

전달된 colorSpecifier를 기반으로 한 0x00RRGGBB 형식으로 높은 수준의 사용자 인터페이스 색 구성표에서 색 하나를 반환합니다.

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)

구성 요소의 상태(강조 표시된/강조 표시되지 않은)에 따라 경계선 그리기에 사용된 입력 스타일을 반환합니다. 예를 들어, 흑백 시스템에서 강조 표시된 항목 주위의 경계선은 SOLID 입력 스타일로 그려야 하는 반면, 강조 표시되지 않은 항목 주위의 경계선은 DOTTED 입력 스타일로 그려야 합니다.

Parameters:

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

Returns:

Graphics.DOTTED 또는 Graphics.SOLID

Since:

MIDP 2.0

isColor

public boolean isColor()

장치의 색 지원에 대한 정보를 가져옵니다.

Returns:

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

numColors

public int numColors()

장치에서 표현할 수 있는 색의 수(isColor()가 true인 경우) 또는 회색 수준(isColor()가 false인 경우)을 가져옵니다.

흑백 디스플레이의 색 수는 2입니다.

Returns:

색의 수

numAlphaLevels

public int numAlphaLevels()

이 구현에서 지원하는 알파 투명도 수준의 수를 가져옵니다. 유효한 최소 반환 값은 2로, 완전 투명도 및 완전 불투명도가 지원되며 블렌딩이 지원되지 않음을 나타냅니다. 2보다 큰 반환 값은 알파 블렌딩이 지원됨을 나타냅니다. 자세한 내용은 알파 처리를 참조하십시오.

Returns:

지원되는 알파 수준 수

Since:

MIDP 2.0

getCurrent

public Displayable getCurrent()

이 MIDlet의 현재 Displayable 객체를 가져옵니다. MIDlet이 백그라운드에서 실행 중이거나 Displayable이 시스템 화면에 의해 흐려진 경우 반환된 Displayable 객체는 실제로 디스플레이에 표시되지 않을 수 있습니다. Displayable이 실제로 디스플레이에 표시되는지 확인하기 위해 Displayable.isShown() 메소드를 호출할 수 있습니다.

getCurrent()가 반환하는 값은 null일 수 있습니다. 이는 응용 프로그램이 초기화된 후 setCurrent()에 대한 첫 번째 호출이 이루어지기 전에 발생합니다.

Returns:

MIDlet의 현재 Displayable 객체

See Also:

setCurrent(javax.microedition.lcdui.Displayable)

setCurrent

public void setCurrent(Displayable nextDisplayable)

다양한 Displayable 객체를 디스플레이에 표시하도록 요청합니다. 일반적으로 변경 사항이 즉시 적용되지는 않습니다. 다음 이벤트 전달 메소드가 호출되기 전에 발생하도록 보장할 수 없지만 이벤트 전달 메소드 호출 사이에 발생하도록 지연시킬 수는 있습니다. setCurrent() 메소드는 변경 사항이 적용될 때까지 기다리지 않고 바로 반환됩니다. 이러한 지연으로 인해 setCurrent()를 호출한 직후에 getCurrent()를 호출하면 setCurrent()에 전달된 값을 반환하지 않습니다.

setCurrent()에 대한 호출은 대기열에 없습니다. setCurrent()에 대한 후속 호출이 setCurrent() 호출에 의해 지연된 요청보다 우선합니다. 예를 들어, 현재 화면이 S1이면 다음과 같이

     d.setCurrent(S2);
     d.setCurrent(S3);     

S2를 완전히 우회하여 결국은 S3이 현재가 되도록 할 수 있습니다.

MIDlet 응용 프로그램을 처음으로 시작하면 현재 Displayable 객체는 없습니다. 응용 프로그램에서는 Displayable을 표시하여 사용자와 항상 상호 작용할 수 있도록 합니다. 따라서 응용 프로그램은 초기화의 일부로 항상 setCurrent()를 호출해야 합니다.

응용 프로그램은 setCurrent()에 대한 인자로 null을 전달합니다. 이로 인해 현재 Displayable이 null로 설정되지 않으며, 대신 현재 Displayable은 변경되지 않은 상태로 남습니다. 하지만 응용 프로그램 관리 소프트웨어는 이 호출을 응용 프로그램이 백그라운드에 놓이도록 요청하는 것으로 해석합니다. 마찬가지로 응용 프로그램이 백그라운드에 있는 경우 setCurrent()에 대해 null이 아닌 참조를 전달하면 응용 프로그램 관리 소프트웨어는 응용 프로그램이 포그라운드에 놓이도록 요청하는 것으로 해석합니다. 현재 Displayable이 setCurrent()에 전달되더라도 이 요청은 이루어진 것으로 간주됩니다. 예를 들어, 다음 코드는

   d.setCurrent(d.getCurrent());    

일반적으로 응용 프로그램을 포그라운드로 가져오도록 요청하는 효과만을 가집니다. 이러한 호출은 요청일 뿐이므로 응용 프로그램 관리 소프트웨어가 적시에 이러한 요청을 따르도록 하는 요구 사항은 없습니다.

setCurrent()에 전달된 Displayable이 Alert이면 이전의 현재 Displayable은(있는 경우) Alert가 닫힌 다음 복원됩니다. 현재 Displayable이 있는 경우 그 효과는 setCurrent(Alert, getCurrent())를 호출한 것과 같습니다. 현재 Displayable이 이미 경고인 경우에는 예외가 발생합니다. 현재 Displayable(시작 시 발생할 수 있는)이 없는 경우 Alert가 닫힌 다음 해당 구현의 이전 상태가 복원됩니다. 이전 Displayable이나 이전 상태에 대한 자동 복원은 Alert가 닫힐 때 해당 기본 수신기가 Alert에 있는 경우에만 발생합니다. 자세한 내용은 Alert 명령 및 수신기를 참조하십시오.

Alert가 닫힌 다음 Displayable이 표시되도록 지정하려면 응용 프로그램은 setCurrent(Alert, Displayable) 메소드를 사용해야 합니다. Alert가 현재일 때 응용 프로그램에서 setCurrent()를 호출하면 Alert가 디스플레이에서 제거되고 설정한 타이머는 취소됩니다.

시스템 화면이 활성 상태일 때 응용 프로그램에서 setCurrent()를 호출하면 시스템 화면이 닫힐 때까지 그 효과가 지연됩니다. 구현 시에는 이러한 경우 setCurrent()를 setCurrent()의 지연 여부와 상관없이 시스템 화면의 효과를 취소하기 위한 요청으로 해석할 것인지 선택할 수 있습니다.

Parameters:

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

See Also:

getCurrent()

setCurrent

public void setCurrent(Alert alert,
                       Displayable nextDisplayable)

이 Alert를 현재로 만들고, Alert가 닫힌 후에는 nextDisplayable을 현재로 만들 것을 요청합니다. Alert의 시간 초과 값이나 모달 경고인지 여부와 상관없이 이 호출은 즉시 반환합니다. nextDisplayable은 Alert가 아니어야 하며 null이 아니어야 합니다.

Alert가 닫힐 때 그 위에 Alert의 기본 수신기가 있는 경우에만 자동으로 nextDisplayable로 진행됩니다. 자세한 내용은 Alert 명령 및 수신기를 참조하십시오.

다른 측면에서 이 메소드는 setCurrent(Displayable)와 동일하게 작동합니다.

Parameters:

alert - 표시되는 경고

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

Throws:

NullPointerException - 경고나 nextDisplayable이 null인 경우

IllegalArgumentException - nextDisplayable이 Alert인 경우

See Also:

Alert, getCurrent()

setCurrentItem

public void setCurrentItem(Item item)

이 Item을 포함하는 Displayable이 현재가 되고 Displayable을 스크롤하여 Item을 표시하고 여기에 해당 초점을 할당하도록 요청합니다. setCurrent(Displayable)를 호출한 것과 마찬가지로 포함된 Displayable을 먼저 현재로 만듭니다. 포함된 Displayable이 현재가 되거나 이미 현재인 경우 필요하면 이를 스크롤하여 요청된 Item을 표시합니다. 그런 다음 구현 시 입력 포커스의 개념이 지원되고 해당 Item이 입력 포커스를 받아들이면 이 입력 포커스가 Item에 할당됩니다.

이 메소드는 Displayable의 전환, 스크롤 및 입력 포커스 할당을 기다리지 않고 항상 즉시 반환합니다.

Item이 컨테이너에 포함되어 있지 않은 경우 오류입니다. Item이 Alert에 포함되어 있는 경우도 오류입니다.

Parameters:

item - 표시되어야 하는 항목

Throws:

IllegalStateException - 컨테이너가 항목을 소유하지 않은 경우

IllegalStateException - Alert가 항목을 소유한 경우

NullPointerException - item이 null인 경우

Since:

MIDP 2.0

callSerially

public void callSerially(Runnable r)

Runnable 객체 r이 해당 run() 메소드를 나중에 호출하여 다시 그리기 주기가 완료된 직후 해당 이벤트 스트림과 일련화되도록 합니다. 패키지 요약의 이벤트 처리 절에 설명된 대로 응용 프로그램에 이벤트 알림을 전달하는 모든 메소드는 순차적으로 호출됩니다. r.run()에 대한 호출은 응용 프로그램으로의 이벤트 호출과 함께 일련화됩니다. callSerially()를 호출할 때마다 정확하게 한 번씩 run() 메소드가 호출됩니다. run()에 대한 호출은 callSerially()에 대한 호출에서 요청한 순서로 발생합니다.

현재 Displayable이 callSerially()를 호출할 때 보류된 다시 그리기가 있는 Canvas인 경우 Canvas의 paint() 메소드가 호출되어 반환하며 Runnable의 run() 메소드가 호출되기 전에 버퍼 전환(이중 버퍼링의 경우)이 발생합니다. 현재 Displayable에 callSerially()를 호출할 때 보류된 다시 그리기가 있는 하나 이상의 CustomItem이 포함되어 있는 경우 CustomItem의 paint() 메소드가 호출되어 Runnable의 run() 메소드가 호출되기 전에 반환합니다. run() 메소드는 적시에 호출되지만 다시 그리기 주기가 종료된 직후나 다음 이벤트가 전달되기 전에도 발생한다는 것을 보장하지는 않습니다.

callSerially() 메소드는 모든 스레드에서 호출될 수 있습니다. run() 메소드에 대한 호출은 callSerially()에 대한 호출과는 독립적으로 발생합니다. 특히 callSerially()는 r.run()에서의 반환을 대기하는 것을 결코 차단하지 않습니다.

다른 콜백과 마찬가지로 r.run()에 대한 호출은 빨리 반환해야 합니다. 오래 실행되는 작업을 수행해야 하는 경우에는 run() 메소드에서 시작할 수 있습니다. 작업 자체는 다른 스레드에서 수행해야 하며 run()에서 반환하는 것을 허용해야 합니다.

callSerially() 기능은 응용 프로그램에서 다시 그리기 주기와 적절하게 동기화되는 애니메이션을 실행하기 위해 사용합니다. 일반적인 응용 프로그램은 프레임이 표시되도록 설정한 다음 repaint()를 호출합니다. 그리고 응용 프로그램은 다음 프레임에 대한 설정이 효력을 발휘하여 해당 프레임이 실제로 표시될 때까지 기다려야 합니다. run()에 대한 호출은 이전 프레임이 그리기를 마쳤음을 응용 프로그램에 알립니다. 아래의 예는 이러한 용도로 사용되는 callSerially()를 보여 줍니다.

     class Animation extends Canvas
         implements Runnable {

     // paint the current frame
     void paint(Graphics g) { ... }

        Display display; // the display for the application

        void paint(Graphics g) { ... } // paint the current frame

        void startAnimation() {
            // set up initial frame
            repaint();
            display.callSerially(this);
        }

        // called after previous repaint is finished
        void run() {
            if ( /* there are more frames */ ) {
                // set up the next frame
                repaint();
                display.callSerially(this);
            }
        }
     }    

Parameters:

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

flashBacklight

public boolean flashBacklight(int duration)

장치의 후광으로 깜박임 효과를 요청합니다. 깜박임 효과는 사용자의 관심을 끌거나 게임의 특수 효과로 사용되는 것이 목적입니다. 깜박임의 예로는 후광 적용 및 해제나 희미함에서 밝음으로 반복적으로 순환하는 것이 있습니다. 반환 값은 응용 프로그램에서 후광의 깜박임을 제어할 수 있는지 여부를 나타냅니다.

요청한 기간 동안 깜박임 효과가 발생하거나 요청한 기간이 0인 경우 해제됩니다. 이 메소드는 즉시 결과를 반환합니다. 즉 깜박임 효과가 실행 중인 동안 호출자를 차단하지 않아야 합니다.

Display가 포그라운드에 있는 경우에만 이 메소드에 대한 호출이 적용됩니다. 이 메소드는 아무런 작업도 수행하지 않고 Display가 백그라운드에 있는 경우 false를 반환해야 합니다.

장치는 기간을 제한하거나 무시할 수 있습니다. 제어 가능한 후광을 포함하지 않은 장치의 경우 이 메소드에 대한 호출은 false를 반환합니다.

Parameters:

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

Returns:

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

Throws:

IllegalArgumentException - duration이 음수인 경우

Since:

MIDP 2.0

vibrate

public boolean vibrate(int duration)

장치의 바이브레이터 작업을 요청합니다. 바이브레이터는 사용자의 관심을 끌거나 게임의 특수 효과로 사용하는 것이 목적입니다. 반환 값은 응용 프로그램이 바이브레이터를 제어할 수 있는지 여부를 나타냅니다.

이 메소드는 요청한 기간 동안 바이브레이터를 적용하거나 요청한 기간이 0인 경우 해제합니다. 바이브레이터가 이전 호출로부터 계속 활성화되어 있는 동안 이 메소드가 호출되면 해당 요청은 새로운 기간 설정으로 해석되며 원래 요청에 새로 시간을 추가하는 것으로 해석되지는 않습니다. 이 메소드는 즉시 결과를 반환합니다. 즉, 바이브레이터가 실행 중인 동안 호출자를 차단하지 않아야 합니다.

이 메소드에 대한 호출은 Display가 포그라운드에 있는 동안에만 적용됩니다. 이 메소드는 아무 작업도 수행하지 않아야 하며 Display가 백그라운드에 있는 경우 false를 반환합니다.

장치는 기간을 제한하거나 무시할 수 있습니다. 제어 가능한 바이브레이터를 포함하지 않는 장치의 경우 이 메소드를 호출하면 false가 반환됩니다.

Parameters:

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

Returns:

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

Throws:

IllegalArgumentException - duration이 음수인 경우

Since:

MIDP 2.0

getBestImageWidth

public int getBestImageWidth(int imageType)

지정된 이미지 유형에 최적인 이미지 너비를 반환합니다. 이미지 유형은 LIST_ELEMENT, CHOICE_GROUP_ELEMENT, ALERT 중 하나여야 합니다.

Parameters:

imageType - 이미지 유형

Returns:

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

Throws:

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

Since:

MIDP 2.0

getBestImageHeight

public int getBestImageHeight(int imageType)

지정된 이미지 유형에 최적인 이미지 높이를 반환합니다. 이미지 유형은 LIST_ELEMENT, CHOICE_GROUP_ELEMENT, ALERT 중 하나여야 합니다.

Parameters:

imageType - 이미지 유형

Returns:

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

Throws:

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

Since:

MIDP 2.0