javax.microedition.lcdui
Class Command

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

public class Command

extends Object

Command 클래스는 작업의 의미 정보를 캡슐화하는 구조입니다. 명령을 활성화하는 동작은 이 객체에서 캡슐화되지 않습니다. 이는 명령에는 명령이 활성화될 때 발생하는 실제 작업이 아닌 "명령"에 대한 정보만 포함된다는 의미입니다. 이 작업은 Displayable과 연관된 CommandListener에 정의됩니다. Command 객체는 사용자 인터페이스에 표시되며 이들이 표시되는 방식은 명령 안에 포함된 의미 정보에 따라 달라질 수 있습니다.

Command는 단일 작업을 활성화하는 의미를 갖는 사용자 인터페이스 구조에 구현될 수 있습니다. 이는 소프트 버튼, 메뉴의 항목 또는 몇 가지 다른 직접 사용자 인터페이스 구조일 수 있습니다. 예를 들어, 음성 인터페이스는 이러한 명령을 음성 태그로 제시할 것입니다.

구체적인 사용자 인터페이스 구조에 대한 매핑은 전체 명령 수에 따라서도 달라질 수 있습니다. 예를 들어, 장치에서 사용 가능한 물리적 버튼에 매핑하는 것보다 더 추상적인 명령을 응용 프로그램에서 요구하는 경우 장치는 메뉴 같은 대체 사용자 인터페이스를 사용할 수 있습니다. 그 예로 물리적 버튼에 매핑할 수 없는 추상 명령은 메뉴에 놓이며 레이블 "메뉴"는 프로그래밍 가능한 버튼 중 하나에 매핑됩니다.

하나의 명령에는 짧은 레이블, 선택적 긴 레이블, 유형, 우선 순위의 네 가지 정보가 포함됩니다. 레이블 중 하나는 명령을 시각적으로 표현하는 데 사용되며 유형과 우선 순위는 명령의 의미를 나타냅니다.

레이블

각 명령에는 한두 개의 레이블 문자열이 포함됩니다. 레이블 문자열은 이 명령을 표현하기 위해 응용 프로그램이 사용자에게 표시하도록 요청하는 내용입니다. 예를 들어, 이러한 문자열 중 하나는 장치의 소프트 버튼 옆이나 메뉴의 한 요소로 표시됩니다. SCREEN 이외의 명령 유형의 경우 제공된 레이블은 이 장치의 이 명령에 더 적합한 시스템별 레이블에 의해 무시될 수 있습니다. 그렇지 않은 경우 레이블 문자열의 내용은 구현 시 해석되지 않습니다.

모든 명령에는 짧은 레이블이 있습니다. 긴 레이블은 선택 사항입니다. 긴 레이블이 명령에 없는 경우 항상 짧은 레이블이 사용됩니다.

짧은 레이블 문자열은 화면 면적을 최소로 차지하도록 가능한 한 짧아야 합니다. 긴 레이블은 더 길고 설명이 보다 자세하지만 몇 단어를 초과하면 안 됩니다. 예를 들어, 명령의 짧은 레이블은 "Play"이고 긴 레이블은 "Play Sound Clip"일 수 있습니다.

구현 시 컨텍스트와 사용 가능한 공간을 기반으로 사용자 인터페이스에 제시할 레이블 중 하나를 선택합니다. 예를 들어, 명령이 소프트 버튼에 표시되면 구현 시 짧은 레이블을 사용하며, 명령이 메뉴에 표시되고 해당 메뉴에 긴 레이블을 표시할 공간이 있는 경우에만 긴 레이블을 사용합니다. 구현 시 일부 명령의 짧은 레이블과 다른 명령의 긴 레이블을 사용할 수 있으며 짧은 레이블과 긴 레이블의 사용을 마음대로 전환할 수 있습니다. 응용 프로그램은 특정 시간에 사용될 레이블을 결정할 수 없습니다.

유형

응용 프로그램은 해당 명령 유형을 사용하여 이 명령의 의도를 지정합니다. 예를 들어, 응용 프로그램에서 명령의 유형을 BACK으로 지정하고 특정 소프트 버튼에 "뒤로" 작업을 둘 수 있는 표준이 장치에 있으면 구현 시 의미 정보를 가이드로 사용하여 장치의 스타일을 따를 수 있습니다. 정의된 유형은 BACK, CANCEL, EXIT, HELP, ITEM, OK, SCREEN 및 STOP입니다.

우선 순위

응용 프로그램은 우선 순위 값을 사용하여 같은 화면의 다른 명령과 관련하여 이 명령의 중요성을 설명합니다. 우선 순위 값은 정수이며 낮은 숫자는 더 큰 중요성을 나타냅니다. 실제 값은 응용 프로그램에서 선택합니다. 우선 순위 값 1은 가장 중요한 명령을 나타내며 우선 순위 값 2, 3, 4 등은 덜 중요한 명령을 나타냅니다.

일반적으로 구현 시 먼저 명령 유형에 따라 명령 위치를 선택한 다음 우선 순위에 따라 유사한 명령을 놓습니다. 이는 가장 높은 우선 순위를 갖는 명령은 사용자가 직접 트리거할 수 있도록 놓이며 낮은 순위를 갖는 명령은 메뉴에 놓인다는 것을 의미합니다. 같은 화면에 같은 우선 순위와 유형을 가진 명령이 있는 것은 오류가 아닙니다. 이 경우 구현 시 명령의 표시 순서를 선택합니다.

예를 들어, 응용 프로그램에 다음 명령이 있는 경우

    new Command("Buy", Command.ITEM, 1);
    new Command("Info", Command.ITEM, 1);
    new Command("Back", Command.BACK, 1);    

두 개의 소프트 버튼이 있는 구현은 BACK 명령을 오른쪽 소프트 버튼에 매핑한 다음 다른 명령을 포함할 수 있도록 왼쪽 소프트 버튼에 "옵션" 메뉴를 만듭니다.

사용자가 왼쪽 소프트 버튼을 누르면 나머지 두 개의 Command가 있는 메뉴가 다음과 같이 표시됩니다.

응용 프로그램에 세 개의 소프트 버튼이 있는 경우 다음과 같이 모든 명령을 소프트 버튼에 매핑할 수 있습니다.

응용 프로그램은 항상 사용자에게 다양한 화면을 통해 진행할 수 있는 수단을 제공해야 합니다. 응용 프로그램에서 아무런 명령이 없는 화면을 설정할 수도 있습니다. 이는 API에서 가능하지만 일반적으로 유용하지는 않습니다. 이러한 경우 사용자는 다른 화면으로 이동할 방법이 없습니다. 이러한 프로그램은 단순히 오류로 간주될 것입니다. 일반적인 장치는 사용자가 응용 프로그램 관리자에게 오류가 있는 응용 프로그램을 종료할 것을 지시할 수 있는 수단을 제공해야 합니다.

Since:

MIDP 1.0

Field Summary

static int	BACK 논리적으로 이전 화면으로 사용자를 되돌리는 이동 명령.
static int	CANCEL 현재 화면에서 구현하는 대화 상자에 대한 표준 부정 대답인 명령.
static int	EXIT 응용 프로그램을 종료하기 위해 사용되는 명령.
static int	HELP 이 명령은 온라인 도움말에 대한 요청을 지정합니다.
static int	ITEM 응용 프로그램은 이 명령 유형을 사용하여 해당 명령이 Screen의 항목이나 Choice의 요소에 고유하다는 것을 구현에 알려줄 수 있습니다.
static int	OK 현재 화면에 의해 구현되는 대화 상자에 대한 표준 긍정 대답인 명령.
static int	SCREEN 현재 화면과 관련된 응용 프로그램 정의 명령을 지정합니다.
static int	STOP 현재 실행 중인 일부 프로세스, 작업 등을 중지하는 명령입니다.

Constructor Summary

Command(String label, int commandType, int priority)
지정된 짧은 레이블, 유형 및 우선 순위를 사용하여 새 명령 객체를 만듭니다.

Command(String shortLabel, String longLabel, int commandType, int priority)
지정된 레이블, 유형 및 우선 순위를 사용하여 새 명령 객체를 만듭니다.

Method Summary

int	getCommandType() 명령의 유형을 가져옵니다.
String	getLabel() 명령의 짧은 레이블을 가져옵니다.
String	getLongLabel() 명령의 긴 레이블을 가져옵니다.
int	getPriority() 명령의 우선 순위를 가져옵니다.

Methods inherited from class java.lang.Object

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

Field Detail

SCREEN

public static final int SCREEN

현재 화면과 관련된 응용 프로그램 정의 명령을 지정합니다. 그 예는 "Load"와 "Save"입니다. SCREEN 명령은 일반적으로 전체 화면의 내용이나 화면 간 이동에 적용됩니다. 이 명령은 이 화면에 있는 현재 활성화되거나 포커스된 항목이나 요소에 적용되는 ITEM 유형과는 반대입니다.

값 1은 SCREEN에 할당됩니다.

See Also:

Constant Field Values

BACK

public static final int BACK

논리적으로 이전 화면으로 사용자를 되돌리는 이동 명령. 이전 화면으로의 이동은 구현 시 자동으로 이루어지는 것이 아니라 응용 프로그램이 제공하는 commandAction에 의해 이루어집니다. 엄격히 이전 화면은 논리적으로 올바르지 않을 수 있으므로 응용 프로그램에서 실제 작업을 정의합니다.

값 2는 BACK에 할당됩니다.

See Also:

CANCEL, STOP, Constant Field Values

CANCEL

public static final int CANCEL

현재 화면에서 구현하는 대화 상자에 대한 표준 부정 대답인 명령. 구현 시 자동으로 취소되는 것은 없습니다. 응용 프로그램에서 제공하는 commandAction에 의해 취소가 구현됩니다.

응용 프로그램은 이 명령 유형을 사용하여 사용자가 현재 화면에 입력한 내용에 아무 작업을 수행하지 않은 채 현재 화면을 닫고자 한다는 것과 일반적으로는 이전 화면으로 돌아가려고 한다는 것을 구현에 알립니다. 많은 경우 CANCEL은 BACK과 교환하여 사용할 수 있지만 BACK은 브라우저 지향 응용 프로그램에서의 이동에 주로 사용됩니다.

값 3은 CANCEL에 할당됩니다.

See Also:

BACK, STOP, Constant Field Values

OK

public static final int OK

현재 화면에 의해 구현되는 대화 상자에 대한 표준 긍정 대답인 명령. 구현 시 자동으로 이루어지는 작업은 없습니다. 응용 프로그램에서 제공하는 commandAction에 의해 수행된 동작이 구현됩니다.

응용 프로그램은 이 명령 유형을 사용하여 사용자가 이 명령을 사용하여 현재 화면에 입력된 데이터를 확인하고 다음 논리 화면으로 진행하기 위해 응용 프로그램에 요청할 것임을 구현에 알립니다.

CANCEL은 종종 OK와 함께 사용됩니다.

값 4가 OK에 할당됩니다.

See Also:

CANCEL, Constant Field Values

HELP

public static final int HELP

이 명령은 온라인 도움말에 대한 요청을 지정합니다. 구현 시 자동으로 표시되는 도움말 정보는 없습니다. 응용 프로그램에서 제공하는 commandAction에서 도움말 정보를 표시해야 합니다.

값 5가 HELP에 할당됩니다.

See Also:

Constant Field Values

STOP

public static final int STOP

현재 실행 중인 일부 프로세스, 작업 등을 중지하는 명령입니다. 구현에 의해 자동으로 중지되는 작업은 없습니다. 중지 작업은 응용 프로그램이 제공하는 commandAction에 의해 수행되어야 합니다.

이 명령 유형을 통해 응용 프로그램은 사용자가 이 명령을 사용하여 현재 화면에 사용자에게 표시되는 현재 실행 중인 모든 프로세스를 중지한다는 것을 구현에 알려줍니다. 실행 중인 프로세스의 예로는 데이터 다운로드나 보내기 등이 있습니다. STOP 명령의 사용이 반드시 다른 화면으로의 전환을 의미하는 것은 아닙니다.

값 6이 STOP에 할당됩니다.

See Also:

BACK, CANCEL, Constant Field Values

EXIT

public static final int EXIT

응용 프로그램을 종료하기 위해 사용되는 명령. 사용자가 이 명령을 호출하면 구현 시 자동으로 종료되지 않습니다. 응용 프로그램의 commandAction이 호출되며 적절한 때에 응용 프로그램을 종료해야 합니다.

값 7이 EXIT에 할당됩니다.

See Also:

Constant Field Values

ITEM

public static final int ITEM

응용 프로그램은 이 명령 유형을 사용하여 해당 명령이 Screen의 항목이나 Choice의 요소에 고유하다는 것을 구현에 알려줄 수 있습니다. 일반적으로 이는 명령이 포커스된 항목이나 요소와 관련되어 있다는 것을 의미합니다. 예를 들어, List 구현 시 이 정보를 사용하여 상황에 맞는 메뉴를 만들 수 있습니다.

값 8이 ITEM에 할당됩니다.

See Also:

Constant Field Values

Constructor Detail

Command

public Command(String label,
               int commandType,
               int priority)

지정된 짧은 레이블, 유형 및 우선 순위를 사용하여 새 명령 객체를 만듭니다. 새로 만든 명령에는 긴 레이블이 없습니다. 이 구성자는 Command(label, null, commandType, priority)와 동일합니다.

Parameters:

label - 명령의 짧은 레이블

commandType - 명령의 유형

priority - 명령의 우선 순위 값

Throws:

NullPointerException - 레이블이 null인 경우

IllegalArgumentException - commandType이 유효하지 않은 유형인 경우

See Also:

Command(String, String, int, int)

Command

public Command(String shortLabel,
               String longLabel,
               int commandType,
               int priority)

지정된 레이블, 유형 및 우선 순위를 사용하여 새 명령 객체를 만듭니다.

짧은 레이블은 필수이며 null이면 안 됩니다. 긴 레이블은 선택 사항이며 명령에 긴 레이블이 없는 경우 null일 수 있습니다.

Parameters:

shortLabel - 명령의 짧은 레이블

longLabel - 명령의 긴 레이블, 또는 긴 레이블이 없는 경우 null

commandType - 명령의 유형

priority - 명령의 우선 순위 값

Throws:

NullPointerException - shortLabel이 null인 경우

IllegalArgumentException - commandType이 유효하지 않은 유형인 경우

Since:

MIDP 2.0

Method Detail

getLabel

public String getLabel()

명령의 짧은 레이블을 가져옵니다.

Returns:

Command의 짧은 레이블

getLongLabel

public String getLongLabel()

명령의 긴 레이블을 가져옵니다.

Returns:

Command의 긴 레이블, 또는 Command에 긴 레이블이 없는 경우 null

Since:

MIDP 2.0

getCommandType

public int getCommandType()

명령의 유형을 가져옵니다.

Returns:

Command의 유형

getPriority

public int getPriority()

명령의 우선 순위를 가져옵니다.

Returns:

Command의 우선 순위