javax.microedition.lcdui
Class ChoiceGroup

java.lang.Object
  |
  +--javax.microedition.lcdui.Item
        |
        +--javax.microedition.lcdui.ChoiceGroup

All Implemented Interfaces:

Choice

public class ChoiceGroup

extends Item

implements Choice

ChoiceGroup은 Form 내에 놓을 선택 가능한 요소 그룹입니다. 이 그룹은 단일 선택을 만들 필요가 있거나 다중 선택이 가능한 모드에서 만들어질 수 있습니다. 구현 시에는 이러한 모드의 그래픽 표현을 제공해야 하며 여러 모드에 대한 여러 그래픽을 시각적으로 제공해야 합니다. 예를 들어, 단일 선택 모드에 대해서는 "라디오 버튼"을, 다중 선택 모드에 대해서는 "확인란"을 사용할 수 있습니다.

주: 대부분의 필수 메소드는 Choice 인터페이스에 지정되어 있습니다.

Since:

MIDP 1.0

Field Summary

Fields inherited from class javax.microedition.lcdui.Item

BUTTON, HYPERLINK, LAYOUT_2, LAYOUT_BOTTOM, LAYOUT_CENTER, LAYOUT_DEFAULT, LAYOUT_EXPAND, LAYOUT_LEFT, LAYOUT_NEWLINE_AFTER, LAYOUT_NEWLINE_BEFORE, LAYOUT_RIGHT, LAYOUT_SHRINK, LAYOUT_TOP, LAYOUT_VCENTER, LAYOUT_VEXPAND, LAYOUT_VSHRINK, PLAIN

Fields inherited from interface javax.microedition.lcdui.Choice

EXCLUSIVE, IMPLICIT, MULTIPLE, POPUP, TEXT_WRAP_DEFAULT, TEXT_WRAP_OFF, TEXT_WRAP_ON

Constructor Summary

ChoiceGroup(String label, int choiceType)
새로운 빈 ChoiceGroup을 만들고 제목과 유형을 지정합니다.

ChoiceGroup(String label, int choiceType, String[] stringElements, Image[] imageElements)
새 ChoiceGroup을 만들어 제목, ChoiceGroup의 유형 및 초기 내용으로 사용될 Strings와 Images의 배열을 지정합니다.

Method Summary

int	append(String stringPart, Image imagePart) 요소를 ChoiceGroup에 추가합니다.
void	delete(int elementNum) elementNum에서 참조하는 요소를 삭제합니다.
void	deleteAll() 이 ChoiceGroup에서 요소를 모두 삭제합니다.
int	getFitPolicy() Choice 요소 내용을 사용 가능한 화면 크기에 맞추기 위한 응용 프로그램의 권장 정책을 가져옵니다.
Font	getFont(int elementNum) 이 Choice의 지정된 요소를 렌더링하기 위한 응용 프로그램의 기본 글꼴을 가져옵니다.
Image	getImage(int elementNum) elementNum에서 참조하는 요소의 Image 부분을 가져옵니다.
int	getSelectedFlags(boolean[] selectedArray_return) ChoiceGroup의 상태를 쿼리하여 부울 배열 selectedArray_return에 있는 모든 요소의 상태를 반환합니다.
int	getSelectedIndex() 선택된 ChoiceGroup에서 요소의 색인 번호를 반환합니다.
String	getString(int elementNum) elementNum에서 참조하는 요소의 String 부분을 가져옵니다.
void	insert(int elementNum, String stringPart, Image imagePart) ChoiceGroup에 지정된 요소 바로 앞에 요소를 삽입합니다.
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) ChoiceGroup의 모든 요소를 선택된 상태로 설정하려고 합니다.
void	setSelectedIndex(int elementNum, boolean selected) MULTIPLE 유형의 ChoiceGroup 객체의 경우 단순히 개별 요소의 선택된 상태를 설정합니다.
int	size() ChoiceGroup에 있는 요소의 수를 반환합니다.

Methods inherited from class javax.microedition.lcdui.Item

addCommand, getLabel, getLayout, getMinimumHeight, getMinimumWidth, getPreferredHeight, getPreferredWidth, notifyStateChanged, removeCommand, setDefaultCommand, setItemCommandListener, setLabel, setLayout, setPreferredSize

Methods inherited from class java.lang.Object

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

Constructor Detail

ChoiceGroup

public ChoiceGroup(String label,
                   int choiceType)

새로운 빈 ChoiceGroup을 만들고 제목과 유형을 지정합니다. 유형은 EXCLUSIVE, MULTIPLE, POPUP 중 하나여야 합니다. IMPLICIT 선택 유형은 ChoiceGroup 내에서는 허용되지 않습니다.

Parameters:

label - 항목의 레이블(Item 참조)

choiceType - EXCLUSIVE, MULTIPLE 또는 POPUP

Throws:

IllegalArgumentException - choiceType이 EXCLUSIVE, MULTIPLE, POPUP 중 하나가 아닌 경우

See Also:

Choice.EXCLUSIVE, Choice.MULTIPLE, Choice.IMPLICIT, Choice.POPUP

ChoiceGroup

public ChoiceGroup(String label,
                   int choiceType,
                   String[] stringElements,
                   Image[] imageElements)

새 ChoiceGroup을 만들어 제목, ChoiceGroup의 유형 및 초기 내용으로 사용될 Strings와 Images의 배열을 지정합니다.

유형은 EXCLUSIVE, MULTIPLE, POPUP 중 하나여야 합니다. IMPLICIT 유형은 ChoiceGroup에는 허용되지 않습니다.

stringElements 배열은 null이 아니어야 하며 모든 배열 요소도 null이 아니어야 합니다. stringElements 배열의 길이는 ChoiceGroup에 있는 요소 수를 결정합니다. imageElements 배열은 ChoiceGroup 요소에 이미지가 없음을 나타내기 위해 null일 수 있습니다. imageElements 배열이 null이 아닌 경우 stringElements 배열과 길이가 같아야 합니다. imageElements 배열의 개별 요소는 해당 ChoiceGroup 요소의 이미지가 없음을 나타내기 위해 null일 수 있습니다. imageElements 배열의 null이 아닌 요소는 변경 가능하거나 변경 불가능한 이미지를 참조할 수 있습니다.

Parameters:

label - 항목의 레이블(Item 참조)

choiceType - EXCLUSIVE, MULTIPLE 또는 POPUP

stringElements - ChoiceGroup 요소의 문자열 부분을 지정하는 문자열 집합

imageElements - ChoiceGroup 요소의 이미지 부분을 지정하는 이미지 집합

Throws:

NullPointerException - stringElements가 null인 경우

NullPointerException - stringElements 배열에 null 요소가 포함되어 있는 경우

IllegalArgumentException - imageElements 배열이 null이 아니고 stringElements 배열의 길이와 다른 경우

IllegalArgumentException - choiceType이 EXCLUSIVE, MULTIPLE, POPUP 중 하나가 아닌 경우

See Also:

Choice.EXCLUSIVE, Choice.MULTIPLE, Choice.IMPLICIT, Choice.POPUP

Method Detail

size

public int size()

ChoiceGroup에 있는 요소의 수를 반환합니다.

Specified by:

size in interface Choice

Returns:

ChoiceGroup에 있는 요소의 수

getString

public String getString(int elementNum)

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

Specified by:

getString in interface Choice

Parameters:

elementNum - 쿼리되는 요소 색인

Returns:

요소의 문자열 부분

Throws:

IndexOutOfBoundsException - elementNum이 유효하지 않은 경우

See Also:

getImage(int)

getImage

public Image getImage(int elementNum)

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

Specified by:

getImage in interface Choice

Parameters:

elementNum - 쿼리되는 요소의 수

Returns:

요소의 이미지 부분, 또는 이미지가 없는 경우 null

Throws:

IndexOutOfBoundsException - elementNum이 유효하지 않은 경우

See Also:

getString(int)

append

public int append(String stringPart,
                  Image imagePart)

요소를 ChoiceGroup에 추가합니다.

Specified by:

append in interface Choice

Parameters:

stringPart - 추가되는 요소의 문자열 부분

imagePart - 추가되는 요소의 이미지 부분 또는 이미지 부분이 없는 경우 null

Returns:

요소의 할당된 색인

Throws:

NullPointerException - stringPart가 null인 경우

insert

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

ChoiceGroup에 지정된 요소 바로 앞에 요소를 삽입합니다.

Specified by:

insert in interface Choice

Parameters:

elementNum - 삽입이 발생하는 요소 색인

stringPart - 삽입되는 요소의 문자열 부분

imagePart - 삽입되는 요소의 이미지 부분 또는 이미지 부분이 없는 경우 null

Throws:

IndexOutOfBoundsException - elementNum이 유효하지 않은 경우

NullPointerException - stringPart가 null인 경우

delete

public void delete(int elementNum)

elementNum에서 참조하는 요소를 삭제합니다.

Specified by:

delete in interface Choice

Parameters:

elementNum - 삭제되는 요소 색인

Throws:

IndexOutOfBoundsException - elementNum이 유효하지 않은 경우

deleteAll

public void deleteAll()

이 ChoiceGroup에서 요소를 모두 삭제합니다.

Specified by:

deleteAll in interface Choice

set

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

요소의 이전 내용을 바꿔 elementNum에서 참조하는 요소의 String 및 Image 부분을 설정합니다.

Specified by:

set in interface Choice

Parameters:

elementNum - 설정되는 요소 색인

stringPart - 새 요소의 문자열 부분

imagePart - 요소의 이미지 부분 또는 이미지 부분이 없는 경우 null

Throws:

IndexOutOfBoundsException - elementNum이 유효하지 않은 경우

NullPointerException - stringPart가 null인 경우

isSelected

public boolean isSelected(int elementNum)

이 요소의 선택 여부를 나타내는 부울 값을 가져옵니다.

Specified by:

isSelected in interface Choice

Parameters:

elementNum - 쿼리되는 요소 색인

Returns:

요소의 선택 상태

Throws:

IndexOutOfBoundsException - elementNum이 유효하지 않은 경우

getSelectedIndex

public int getSelectedIndex()

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

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

Specified by:

getSelectedIndex in interface Choice

Returns:

선택한 요소의 색인 또는 색인이 없는 경우 -1

See Also:

setSelectedIndex(int, boolean)

getSelectedFlags

public int getSelectedFlags(boolean[] selectedArray_return)

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

MULTIPLE 유형의 ChoiceGroup 객체의 경우 여러 요소가 선택될 수 있으며 결과 배열에 true로 설정됩니다. EXCLUSIVE 및 POPUP 유형의 ChoiceGroup 객체의 경우 정확히 한 개의 요소만 선택됩니다(ChoiceGroup에 요소가 있는 경우).

Specified by:

getSelectedFlags in interface Choice

Parameters:

selectedArray_return - 결과를 포함할 배열

Returns:

ChoiceGroup에 선택된 요소의 수

Throws:

IllegalArgumentException - selectedArray_return이 ChoiceGroup의 크기보다 짧은 경우

NullPointerException - selectedArray_return이 null인 경우

See Also:

setSelectedFlags(boolean[])

setSelectedIndex

public void setSelectedIndex(int elementNum,
                             boolean selected)

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

EXCLUSIVE 및 POPUP 유형의 ChoiceGroup 객체의 경우는 요소를 선택하는 데만 사용할 수 있습니다. 즉 selected 매개 변수는 true여야 합니다. 요소를 선택하면 이전에 선택한 요소는 선택 취소됩니다. selected가 false인 경우 이 호출은 무시됩니다.

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

Specified by:

setSelectedIndex in interface Choice

Parameters:

elementNum - 요소의 수. 요소의 색인은 0에서 시작합니다.

selected - 요소의 새 상태, true=selected, false=not selected

Throws:

IndexOutOfBoundsException - elementNum이 유효하지 않은 경우

See Also:

getSelectedIndex()

setSelectedFlags

public void setSelectedFlags(boolean[] selectedArray)

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

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

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

Specified by:

setSelectedFlags in interface Choice

Parameters:

selectedArray - 메소드가 선택 상태를 수집하는 배열

Throws:

IllegalArgumentException - selectedArray가 ChoiceGroup의 크기보다 짧은 경우

NullPointerException - selectedArray가 null인 경우

See Also:

getSelectedFlags(boolean[])

setFitPolicy

public void setFitPolicy(int fitPolicy)

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

Specified by:

setFitPolicy in interface Choice

Parameters:

fitPolicy - 선택 사항 요소의 기본 내용 맞춤 정책

Throws:

IllegalArgumentException - fitPolicy가 유효하지 않은 경우

Since:

MIDP 2.0

See Also:

getFitPolicy()

getFitPolicy

public int getFitPolicy()

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

Specified by:

getFitPolicy in interface Choice

Returns:

Choice.TEXT_WRAP_DEFAULT, Choice.TEXT_WRAP_ON 또는 Choice.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이면 구현 시 기본 글꼴을 사용하여 요소를 렌더링해야 합니다.

Specified by:

setFont in interface Choice

Parameters:

elementNum - 0부터 시작하는 요소의 색인

font - 요소 렌더링에 사용할 기본 글꼴

Throws:

IndexOutOfBoundsException - elementNum이 유효하지 않은 경우

Since:

MIDP 2.0

See Also:

getFont(int)

getFont

public Font getFont(int elementNum)

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

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

Specified by:

getFont in interface Choice

Parameters:

elementNum - 0부터 시작하는 요소의 색인

Returns:

요소 렌더링에 사용할 기본 글꼴

Throws:

IndexOutOfBoundsException - elementNum이 유효하지 않은 경우

Since:

MIDP 2.0

See Also:

setFont(int elementNum, Font font)