Choice (MID 프로필)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

MID 프로필

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.microedition.lcdui
Interface Choice

All Known Implementing Classes:: ChoiceGroup, List

public interface Choice

Choice는 미리 정의된 선택 항목 개수에서 선택 사항을 구현하는 사용자 인터페이스 구성 요소에 대한 API를 정의합니다. 이러한 UI 구성 요소는 List 및 ChoiceGroup입니다. Choice의 내용은 문자열과 이미지로 표현됩니다.

Choice의 각 요소는 텍스트 문자열 부분, Image 부분 및 모두 한 단위로 처리되는 글꼴 속성으로 구성됩니다. 글꼴 속성은 텍스트 부분에 적용되며 응용 프로그램에서 제어할 수 있습니다. 요소에 이미지 부분이 없는 경우 응용 프로그램은 이미지에 null을 제공할 수 있습니다. 구현 시 텍스트 문자열의 시작 부분에 이미지를 표시해야 합니다. Choice에 또한 텍스트 문자열의 시작 부분에 선택 표시기(라디오 버튼이나 확인란 등)가 있는 경우 해당 요소의 이미지는 선택 표시기와 텍스트 문자열 시작 부분 사이에 있어야 합니다.

새 요소가 삽입되거나 추가되면 구현 시 글꼴 속성의 기본 글꼴이 제공됩니다. 이 기본 글꼴은 응용 프로그램이 setFont(i, null)를 호출할 때 사용하는 글꼴과 같습니다. 모든 ChoiceGroup 인스턴스는 같은 기본 글꼴을 가져야 하며 List 인스턴스도 모두 같은 기본 글꼴을 가져야 합니다. 하지만 Choice 객체에 사용된 기본 글꼴은 Font.getDefaultFont에서 반환하는 글꼴과는 다를 수 있습니다.

Choice 요소의 Image 부분은 변경 가능한 경우도 있고 변경 불가능한 경우도 있습니다. Image가 변경 가능한 경우에는 Choice가 이 Image로 구성되거나 Choice 요소를 append, insert 또는 set 메소드로 만들거나 수정할 때 이미지 내용의 스냅샷을 생성하는 것과 같은 기능을 합니다. Choice 요소의 내용이 표시될 때마다 스냅샷이 사용됩니다. 그 후 응용 프로그램이 해당 Image을 가져오더라도 위 메소드 중 하나에 대한 다음 호출이 있을 때까지 스냅샷은 수정되지 않습니다. Choice가 디스플레이에 표시되어 있으면 스냅샷을 업데이트할 수 없습니다. 이는 응용 프로그램에서 Displayables와 Items가 표시된 다음 디스플레이에서 사라져야 할 정확한 시점을 제어할 수 없기 때문입니다.

다음 코드에서는 Choice ch의 k 요소 이미지 부분을 갱신하는 기술에 대해 설명합니다.


    ch.set(k, ch.getString(k), ch.getImage(k));

응용 프로그램에서 이미지를 제공하고 해당 이미지가 이미지를 표시할 장치 용량을 초과하는 경우 구현 시 이 이미지를 자를지 선택할 수 있습니다. 구현 시 모든 요소에 대해 동일한 양의 공간을 할당할 수 있으므로 특정 Choice 객체 내의 Images는 모두 같은 크기여야 합니다. 응용 프로그램에서 Display.getBestImageWidth(int)와 Display.getBestImageHeight(int)를 호출하여 해당 구현의 이미지 크기 권장 사항을 쿼리할 수 있습니다.

요소가 매우 길거나 줄 바꿈이 포함되어 있는 경우 구현 시 요소의 일부만 표시할 수 있습니다. 이런 경우에는 구현 시 사용자가 가능한 많은 요소를 볼 수 있도록 수단을 제공해야 합니다. 한 요소를 여러 줄에 줄바꿈하여 표시하는 경우에는 두 번째 이후의 줄이 같은 요소의 일부이며 새로운 요소가 아님을 사용자에게 확실히 알려야 합니다.

줄바꿈 문자를 포함하는 요소 등 긴 요소를 표시하기 위해 응용 프로그램은 구현에서 사용하는 정책의 기본 설정을 표시할 수 있습니다. 첫 번째 줄바꿈 이후의 문자는 정책이 허용하는 경우에만 표시됩니다. setFitPolicy(int)와 getFitPolicy() 메소드는 이 기본 설정을 제어합니다. 유효한 설정은 TEXT_WRAP_DEFAULT, TEXT_WRAP_ON 및 TEXT_WRAP_OFF입니다. Choice 클래스 구현 시 다르게 지정하지 않는 한 요소 맞춤 정책의 초기값은 TEXT_WRAP_DEFAULT입니다.

Choice 객체가 만들어진 다음 요소를 삽입, 추가, 삭제할 수 있으며 각 요소의 문자열 부분 및 이미지 부분을 가져와서 설정할 수 있습니다. Choice 객체 내의 요소는 0에서 size()-1의 범위에 있는 연속 정수인 색인에 의해 참조됩니다. 이 경우 0은 첫 번째 요소를, size()-1은 마지막 요소를 의미합니다.

Choice의 유형은 네 가지로 암시적 선택(List에만 유효), 배타적 선택, 다중 선택 및 팝업(ChoiceGroup에만 유효)이 있습니다.

배타적 선택은 일련의 요소를 나타내며 사용자와 상호 작용합니다. 즉, 사용자가 하나의 요소를 선택하면 해당 요소는 구분되는 시각적 표현을 사용하여 선택된 것으로 표시됩니다. Choice에 요소가 있는 경우에는 지정된 시간에 하나의 요소만 선택되어야 합니다. 언제든 배타적 선택에 요소가 있지만 아무 요소도 선택되어 있지 않은 상황이 발생하는 경우 구현 시 하나의 요소를 선택합니다. 요소가 비어 있는 Choice에 추가되거나 Choice에서 선택한 요소를 삭제하거나 구성자가 Choice를 만들어 요소를 채우는 경우 이러한 상황이 발생할 수 있습니다. 이러한 경우에는 선택할 요소가 구현 시 선택됩니다. 선택한 요소가 중요한 의미를 갖는 응용 프로그램에는 해당 선택을 명시적으로 설정해야 합니다. 배타적 Choice 내에서 사용자가 요소를 선택 취소할 수 있는 방법은 없습니다.

팝업 선택은 배타적 선택과 유사합니다. 팝업 선택의 선택 동작은 배타적 선택의 선택 동작과 동일합니다. 하지만 팝업 선택은 표현 및 상호 작용 면에 있어 배타적 선택과 다릅니다. 배타적 선택에서 모든 요소는 일렬로 표시되어야 합니다. 팝업 선택에서 선택한 요소는 항상 표시되어야 하지만 다른 요소는 사용자가 이를 표시하기 위해 특정 작업을 수행하기 전에는 숨겨져 있습니다. 예를 들어, 배타적 선택은 한 버튼이 항상 선택되어 있는 일련의 라디오 버튼으로 구현될 수 있습니다. 팝업 선택은 메뉴 버튼에 선택한 요소가 표시되어 있는 팝업 메뉴로 구현될 수 있습니다.

암시적 선택은 명령이 시작될 때 포커스되거나 강조 표시된 요소가 암시적으로 선택되는 배타적 선택입니다. 배타적 선택과 마찬가지로 Choice에 요소가 있는 경우 하나의 요소가 항상 선택되어 있습니다.

다중 선택은 일련의 요소를 나타내며 사용자가 여러 요소를 조합하여 선택할 수 있도록 합니다. 배타적 선택과 마찬가지로 다중 선택은 객체 작업 모드에서 사용자와 상호 작용합니다. 다중 선택의 시각적 표현은 사용자에게 여러 요소를 선택할 수 있음을 알릴 뿐 아니라 각 요소의 선택 상태를 표시하는 배타적 선택과는 구분된 시각적 표현을 가질 것입니다.

요소의 선택된 상태는 해당 요소의 등록 정보입니다. 다른 요소가 삽입되거나 삭제되면 요소를 이동시켜 해당 요소에 이 상태가 지속됩니다. 예를 들어, 요소 n이 선택되고 새 요소가 색인 0에 삽입된 경우 선택된 요소는 이제 색인 n+1을 갖게 됩니다. 삭제에도 유사한 규칙이 적용됩니다. n이 0보다 크다고 가정하면 요소 0을 삭제하는 경우 요소 n-1이 선택됩니다. 요소의 내용을 설정하면 선택된 상태가 변경되지 않은 상태로 남습니다. 새 요소가 삽입되거나 추가되면 항상 선택되지 않습니다(위에 언급된 대로 빈 Exclusive, Popup 또는 Implicit Choice에 요소를 추가하는 특수한 경우는 제외).

Choice 객체의 선택된 상태는 응용 프로그램에서 setSelectedFlags 및 setSelectedIndex 메소드와 함께 제어할 수 있습니다. 이 상태는 getSelectedFlags와 getSelectedIndex 메소드를 통해 응용 프로그램에서 사용할 수 있습니다. 이 메소드에 의해 보고되는 선택된 상태는 다음을 제외하면 대체로 응용 프로그램에 의해 설정된 내용과 동일합니다. 요소를 추가하거나 제거하면 선택이 변경될 수 있습니다. Choice가 디스플레이에 있으면 구현의 사용자 인터페이스 정책 및 객체와의 직접 사용자 상호 작용도 선택에 영향을 미칩니다. 예를 들어, 구현 시 사용자가 강조 표시를 이동함에 따라 해당 선택을 현재 강조 표시 위치로 업데이트하거나 사용자가 명령을 호출하려고 할 때만 해당 강조 표시에서 선택을 설정할 수 있습니다. 또 다른 예로는 구현 시 List가 현재가 될 때마다 암시적 List의 강조 표시(및 선택)를 첫 번째 요소로 이동할 수 있습니다. Choice 객체가 디스플레이에 있으면 응용 프로그램은 CommandListener나 ItemStateListener 콜백 내에서만 선택된 상태를 쿼리해야 합니다. 다른 경우에 상태를 쿼리하면 응용 프로그램에서 설정한 내용과 다른 값이 될 수 있으며(사용자나 구현의 UI 정책이 값을 바꿀 수 있으므로) 사용자의 의도(사용자가 아직 선택하는 중일 수 있으므로)를 반영하지 않을 수 있습니다.

주: 메소드는 버전 2.0의 Choice 인터페이스에 추가되었습니다. 인터페이스에 메소드를 추가하는 것은 기본적으로 비호환성 변경입니다. 하지만 Choice는 필드의 유형이나 메소드 매개 변수 또는 메소드 반환 값으로는 표시되지 않으므로 응용 프로그램에서 Choice 인터페이스를 구현하는 클래스를 만들 때는 유용하지 않습니다. 이 사양의 이후 버전에서 Choice 인터페이스가 추가로 변경될 수 있습니다. 이 사양의 이후 버전과 호환되도록 하려면 응용 프로그램에서 Choice 인터페이스를 구현하는 클래스를 만들지 말아야 합니다.

Since:: MIDP 1.0

Field Summary

static int EXCLUSIVE
          EXCLUSIVE는 한 번에 정확히 한 요소만 선택하는 선택 방법입니다.

static int IMPLICIT
          IMPLICIT는 Command가 시작될 때 현재 포커스된 요소를 선택하는 선택 방법입니다.

static int MULTIPLE
          MULTIPLE은 한 번에 여러 요소를 선택할 수 있는 선택 방법입니다.

static int POPUP
          POPUP은 한 번에 정확히 한 요소만 선택하는 선택 방법입니다.

static int TEXT_WRAP_DEFAULT
          응용 프로그램에 텍스트 요소 내용의 줄바꿈이나 자르기에 관한 기본 설정이 없으며 구현 시 기본 동작을 사용해야 함을 나타내는 상수입니다.

static int TEXT_WRAP_OFF
          텍스트 요소 내용이 한 줄로 제한되어야 함을 알리는 상수입니다.

static int TEXT_WRAP_ON
          사용 가능한 내용 공간에 맞추기 위해 필요한 경우 텍스트 요소 내용이 여러 줄에 줄바꿈되어야 함을 알리는 상수입니다.

Method Summary

int append(String stringPart, Image imagePart)
          요소를 Choice에 추가합니다.

void delete(int elementNum)
          elementNum에서 참조하는 요소를 삭제합니다.

void deleteAll()
          Choice에서 요소를 남기지 않고 모든 요소를 삭제합니다.

int getFitPolicy()
          Choice 요소 내용을 사용 가능한 화면 크기에 맞추기 위한 응용 프로그램의 권장 정책을 가져옵니다.

Font getFont(int elementNum)
          이 Choice의 지정된 요소를 렌더링하기 위한 응용 프로그램의 기본 글꼴을 가져옵니다.

Image getImage(int elementNum)
          elementNum에서 참조하는 요소의 Image 부분을 가져옵니다.

int getSelectedFlags(boolean[] selectedArray_return)
          Choice의 상태를 쿼리하여 부울 배열 selectedArray_return에 있는 모든 요소의 상태를 반환합니다.

int getSelectedIndex()
          선택된 Choice 요소의 색인 번호를 반환합니다.

String getString(int elementNum)
          elementNum에서 참조하는 요소의 String 부분을 가져옵니다.

void insert(int elementNum, String stringPart, Image imagePart)
          Choice에서 지정한 요소 바로 앞에 요소를 삽입합니다.

boolean isSelected(int elementNum)
          이 요소의 선택 여부를 나타내는 부울 값을 가져옵니다.

void set(int elementNum, String stringPart, Image imagePart)
          요소의 이전 내용을 바꿔 elementNum에서 참조하는 요소의 String 및 Image 부분을 설정합니다.

void setFitPolicy(int fitPolicy)
          Choice 요소 내용을 사용 가능한 화면 크기에 맞추기 위한 응용 프로그램의 기본 정책을 설정합니다.

void setFont(int elementNum, Font font)
          이 Choice의 지정된 요소를 렌더링하기 위한 응용 프로그램의 기본 글꼴을 설정합니다.

void setSelectedFlags(boolean[] selectedArray)
          Choice의 모든 요소를 선택된 상태로 설정하려고 합니다.

void setSelectedIndex(int elementNum, boolean selected)
          MULTIPLE의 경우 단순히 개별 요소의 선택된 상태를 설정합니다.

int size()
          현재 있는 요소의 수를 가져옵니다.

Field Detail

EXCLUSIVE

public static final int EXCLUSIVE

EXCLUSIVE는 한 번에 정확히 한 요소만 선택하는 선택 방법입니다. EXCLUSIVE 유형 Choice의 모든 요소는 일렬로 표시되어야 합니다. 즉, 사용자는 요소 사이를 이동하고 선택하기 위해 별도의 작업을 수행할 필요가 없습니다.

값 1이 EXCLUSIVE에 할당됩니다.

See Also:: Constant Field Values

MULTIPLE

public static final int MULTIPLE

MULTIPLE은 한 번에 여러 요소를 선택할 수 있는 선택 방법입니다.

값 2가 MULTIPLE에 할당됩니다.

See Also:: Constant Field Values

IMPLICIT

public static final int IMPLICIT

IMPLICIT는 Command가 시작될 때 현재 포커스된 요소를 선택하는 선택 방법입니다.

IMPLICIT 유형은 ChoiceGroup 객체에 유효하지 않습니다.

값 3이 IMPLICIT에 할당됩니다.

See Also:: Constant Field Values

POPUP

public static final int POPUP

POPUP은 한 번에 정확히 한 요소만 선택하는 선택 방법입니다. 선택한 요소는 항상 표시됩니다. 다른 요소는 사용자가 이를 표시하기 위해 특정 동작을 수행하기 전에는 숨겨져 있어야 합니다. 사용자가 이 작업을 수행하면 모든 요소를 액세스할 수 있습니다. 예를 들어, 구현 시 팝업 메뉴를 사용하여 POPUP 유형 ChoiceGroup의 요소를 표시할 수 있습니다.

POPUP 유형은 List 객체에 유효하지 않습니다.

값 4가 POPUP에 할당됩니다.

Since:: MIDP 2.0
See Also:: Constant Field Values

TEXT_WRAP_DEFAULT

public static final int TEXT_WRAP_DEFAULT

응용 프로그램에 텍스트 요소 내용의 줄바꿈이나 자르기에 관한 기본 설정이 없으며 구현 시 기본 동작을 사용해야 함을 나타내는 상수입니다.

필드에는 0 값이 있습니다.

Since:: MIDP 2.0
See Also:: getFitPolicy(), setFitPolicy(int), Constant Field Values

TEXT_WRAP_ON

public static final int TEXT_WRAP_ON

사용 가능한 내용 공간에 맞추기 위해 필요한 경우 텍스트 요소 내용이 여러 줄에 줄바꿈되어야 함을 알리는 상수입니다. 구현 시 실제로 있을 최대 줄 수를 제한할 수 있습니다.

필드에는 1 값이 있습니다.

Since:: MIDP 2.0
See Also:: getFitPolicy(), setFitPolicy(int), Constant Field Values

TEXT_WRAP_OFF

public static final int TEXT_WRAP_OFF

텍스트 요소 내용이 한 줄로 제한되어야 함을 알리는 상수입니다. 줄에 넣어야 할 텍스트가 너무 많은 경우 등에는 해당 줄을 끝내야 합니다. 구현 시에는 전체 요소 내용을 표시할 수 있는 몇 가지 방법을 제공해야 합니다. 특수 팝업 창을 사용하거나 포커스된 요소의 텍스트를 스크롤하는 등의 작업으로 이를 수행할 수 있습니다.

예를 들어, 구현 시에는 텍스트 내용이 잘린 위치에 생략 기호를 두어 잘림이 발생했음을 표시해야 합니다.

필드에는 2 값이 있습니다.

Since:: MIDP 2.0
See Also:: getFitPolicy(), setFitPolicy(int), Constant Field Values

Method Detail

size

public int size()

현재 있는 요소의 수를 가져옵니다.

Returns:: Choice에 있는 요소의 수

getString

public String getString(int elementNum)

elementNum에서 참조하는 요소의 String 부분을 가져옵니다. elementNum 매개 변수는 [0..size()-1] 범위(포함)에 있어야 합니다.

Parameters:: elementNum - 쿼리되는 요소 색인
Returns:: 요소의 문자열 부분
Throws:: IndexOutOfBoundsException - elementNum이 유효하지 않은 경우
See Also:: getImage(int)

getImage

public Image getImage(int elementNum)

elementNum에서 참조하는 요소의 Image 부분을 가져옵니다. elementNum 매개 변수는 [0..size()-1] 범위(포함)에 있어야 합니다.

Parameters:: elementNum - 쿼리되는 요소 색인
Returns:: 요소의 이미지 부분, 또는 이미지가 없는 경우 null
Throws:: IndexOutOfBoundsException - elementNum이 유효하지 않은 경우
See Also:: getString(int)

append

public int append(String stringPart,
                  Image imagePart)

요소를 Choice에 추가합니다. 추가된 요소는 Choice의 마지막 요소가 됩니다. Choice의 크기는 하나씩 늘어납니다.

Parameters:: stringPart - 추가되는 요소의 문자열 부분; imagePart - 추가되는 요소의 이미지 부분 또는 이미지 부분이 없는 경우 null
Returns:: 요소의 할당된 색인
Throws:: NullPointerException - stringPart가 null인 경우

insert

public void insert(int elementNum,
                   String stringPart,
                   Image imagePart)

Choice에서 지정한 요소 바로 앞에 요소를 삽입합니다. Choice의 크기는 하나씩 늘어납니다. elementNum 매개 변수는 [0..size()] 범위(포함)에 있어야 합니다. 마지막 요소의 색인은 size()-1이므로 실제로 색인이 size()인 요소는 없습니다. elementNum에 이 값이 사용된 경우 새 요소는 마지막 요소 바로 뒤에 삽입됩니다. 이 경우 append()와 동일한 기능을 합니다.

Parameters:: elementNum - 삽입이 발생하는 요소 색인; stringPart - 삽입되는 요소의 문자열 부분; imagePart - 삽입되는 요소의 이미지 부분 또는 이미지 부분이 없는 경우 null
Throws:: IndexOutOfBoundsException - elementNum이 유효하지 않은 경우; NullPointerException - stringPart가 null인 경우

delete

public void delete(int elementNum)

elementNum에서 참조하는 요소를 삭제합니다. Choice의 크기는 하나씩 줄어듭니다. Choice에서 모든 요소를 삭제하는 것은 유효합니다. elementNum 매개 변수는 [0..size()-1] 범위(포함)에 있어야 합니다.

Parameters:: elementNum - 삭제되는 요소 색인
Throws:: IndexOutOfBoundsException - elementNum이 유효하지 않은 경우

deleteAll

public void deleteAll()

Choice에서 요소를 남기지 않고 모든 요소를 삭제합니다. Choice가 이미 비어 있는 경우에는 이 메소드는 아무 작업을 수행하지 않습니다.

Since:: MIDP 2.0

set

public void set(int elementNum,
                String stringPart,
                Image imagePart)

요소의 이전 내용을 바꿔 elementNum에서 참조하는 요소의 String 및 Image 부분을 설정합니다. elementNum 매개 변수는 [0..size()-1] 범위(포함)에 있어야 합니다. 해당 요소의 글꼴 속성은 변경되지 않은 상태로 남습니다.

Parameters:: elementNum - 설정되는 요소 색인; stringPart - 새 요소의 문자열 부분; imagePart - 요소의 이미지 부분 또는 이미지 부분이 없는 경우 null
Throws:: IndexOutOfBoundsException - elementNum이 유효하지 않은 경우; NullPointerException - stringPart가 null인 경우

isSelected

public boolean isSelected(int elementNum)

이 요소의 선택 여부를 나타내는 부울 값을 가져옵니다. elementNum 매개 변수는 [0..size()-1] 범위(포함)에 있어야 합니다.

Parameters:: elementNum - 쿼리되는 요소 색인
Returns:: 요소의 선택 상태
Throws:: IndexOutOfBoundsException - elementNum이 유효하지 않은 경우

getSelectedIndex

public int getSelectedIndex()

선택된 Choice 요소의 색인 번호를 반환합니다. Choice 유형 EXCLUSIVE, POPUP 및 IMPLICIT의 경우 한 개 이하의 요소만 선택되므로 이 메소드는 사용자 선택을 확인할 때 유용합니다. Choice에 요소가 없는 경우(따라서 선택된 요소가 없는 경우) -1을 반환합니다.

MULTIPLE의 경우 일반적으로 Choice의 상태를 나타낼 수 있는 단일 값이 없으므로 항상 -1을 반환합니다. MULTIPLE Choice의 전체 상태를 가져오려면 getSelectedFlags를 참조하십시오.

Returns:: 선택한 요소의 색인 또는 색인이 없는 경우 -1
See Also:: setSelectedIndex(int, boolean)

getSelectedFlags

public int getSelectedFlags(boolean[] selectedArray_return)

Choice의 상태를 쿼리하여 부울 배열 selectedArray_return에 있는 모든 요소의 상태를 반환합니다. 주: 결과 매개 변수입니다. 최소한 size()에서 반환하는 Choice 크기의 길이 정도는 되어야 합니다. 배열이 더 길면 해당 초과 요소는 false로 설정됩니다.

이 호출은 모든 Choice 유형에 대해 유효합니다. MULTIPLE의 경우 여러 요소가 선택될 수 있으며 결과 배열에 true로 설정됩니다. EXCLUSIVE, POPUP 및 IMPLICIT의 경우 정확히 한 개의 요소만 선택됩니다(Choice에 요소가 있는 경우).

Parameters:: selectedArray_return - 결과를 포함할 배열
Returns:: Choice에 선택된 요소의 수
Throws:: IllegalArgumentException - selectedArray_return이 Choice의 크기보다 짧은 경우; NullPointerException - selectedArray_return이 null인 경우
See Also:: setSelectedFlags(boolean[])

setSelectedIndex

public void setSelectedIndex(int elementNum,
                             boolean selected)

MULTIPLE의 경우 단순히 개별 요소의 선택된 상태를 설정합니다.

EXCLUSIVE와 POPUP은 요소를 선택하는 데만 사용할 수 있습니다. 즉 selected 매개 변수는 true여야 합니다. 요소를 선택하면 이전에 선택한 요소는 선택 취소됩니다. selected 가 false인 경우 이 호출은 무시됩니다. 요소가 이미 선택되어 있는 경우에는 호출해도 아무 효과가 없습니다.

IMPLICIT는 요소를 선택하는 데만 사용할 수 있습니다. 즉 selected 매개 변수는 true여야 합니다. 요소를 선택하면 이전에 선택한 요소는 선택 취소됩니다. selected 가 false인 경우 이 호출은 무시됩니다. 요소가 이미 선택되어 있는 경우에는 호출해도 아무 효과가 없습니다.

setSelectedIndex에 대한 호출로는 어떤 Command도 암시적으로 활성화하지 않습니다.

모든 목록 유형의 경우 elementNum 매개 변수는 [0..size()-1] 범위(포함)에 있어야 합니다.

Parameters:: elementNum - 0부터 시작하는 요소의 색인; selected - 요소의 상태이며 true는 선택했음을, false는 선택하지 않았음을 의미합니다.
Throws:: IndexOutOfBoundsException - elementNum이 유효하지 않은 경우
See Also:: getSelectedIndex()

setSelectedFlags

public void setSelectedFlags(boolean[] selectedArray)

Choice의 모든 요소를 선택된 상태로 설정하려고 합니다. 배열의 길이는 최소한 Choice의 크기가 되어야 합니다. 배열이 더 길면 추가 값은 무시됩니다.

MULTIPLE 유형의 Choice 객체는 Choice의 모든 요소를 선택된 상태로 설정합니다. 여러 요소가 선택될 수 있습니다.

EXCLUSIVE, POPUP 및 IMPLICIT 유형의 Choice 객체의 경우 정확히 하나의 배열 요소는 true 값을 가져야 합니다. true인 요소가 없으면 Choice의 첫 번째 요소가 선택됩니다. 두 개 이상의 요소가 true인 경우 구현 시 첫 번째 true 요소가 선택되어 사용됩니다.

Parameters:: selectedArray - 메소드가 선택 상태를 수집하는 배열
Throws:: IllegalArgumentException - selectedArray가 Choice의 크기보다 짧은 경우; NullPointerException - selectedArray가 null인 경우
See Also:: getSelectedFlags(boolean[])

setFitPolicy

public void setFitPolicy(int fitPolicy)

Choice 요소 내용을 사용 가능한 화면 크기에 맞추기 위한 응용 프로그램의 기본 정책을 설정합니다. 설정된 정책은 Choice 객체의 모든 요소에 적용됩니다. 유효한 값은 TEXT_WRAP_DEFAULT, TEXT_WRAP_ON 및 TEXT_WRAP_OFF입니다. 맞춤 정책은 힌트일 뿐이며 구현 시 응용 프로그램의 기본 정책을 무시할 수 있습니다.

Parameters:: fitPolicy - 선택 사항 요소의 기본 내용 맞춤 정책
Throws:: IllegalArgumentException - fitPolicy가 유효하지 않은 경우
Since:: MIDP 2.0
See Also:: getFitPolicy()

getFitPolicy

public int getFitPolicy()

Choice 요소 내용을 사용 가능한 화면 크기에 맞추기 위한 응용 프로그램의 권장 정책을 가져옵니다. 반환된 값은 응용 프로그램이 설정한 정책입니다. 이는 구현 시 값을 무시한 경우에도 마찬가지입니다.

Returns:: TEXT_WRAP_DEFAULT, TEXT_WRAP_ON 또는 TEXT_WRAP_OFF 중의 하나
Since:: MIDP 2.0
See Also:: setFitPolicy(int)

setFont

public void setFont(int elementNum,
                    Font font)

이 Choice의 지정된 요소를 렌더링하기 위한 응용 프로그램의 기본 글꼴을 설정합니다. 요소의 글꼴은 힌트일 뿐이며 구현 시 응용 프로그램의 기본 글꼴을 무시할 수 있습니다.

elementNum 매개 변수는 [0..size()-1] 범위(포함)에 있어야 합니다.

font 매개 변수는 유효한 Font 객체이거나 null이어야 합니다. font 매개 변수가 null이면 구현 시 기본 글꼴을 사용하여 요소를 렌더링해야 합니다.

Parameters:: elementNum - 0부터 시작하는 요소의 색인; font - 요소 렌더링에 사용할 기본 글꼴
Throws:: IndexOutOfBoundsException - elementNum이 유효하지 않은 경우
Since:: MIDP 2.0
See Also:: getFont(int)

getFont

public Font getFont(int elementNum)

이 Choice의 지정된 요소를 렌더링하기 위한 응용 프로그램의 기본 글꼴을 가져옵니다. 반환된 값은 응용 프로그램이 설정한 글꼴입니다. 이는 구현 시 값을 무시한 경우에도 마찬가지입니다. 응용 프로그램이 글꼴을 설정하지 않았거나 응용 프로그램이 명시적으로 글꼴을 null로 설정한 경우에는 구현 시 선택한 기본 글꼴이 값이 됩니다.