Class ChoiceGroup

package javax.microedition.lcdui

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

설명

All Implemented Interfaces:

• Choice

implements Choice:

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

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

Since:

• MIDP 1.0

필드 요약

생성자 요약

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

메서드 요약

• 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 에 있는 요소의 수를 반환합니다.

생성자 상세

ChoiceGroup

public ChoiceGroup(String label,
                   int choiceType)

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

Parameters:

• 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:

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

Throws:

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

See Also:

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

size

public int size()

Specified by:

• size in interface Choice

Returns:

• ChoiceGroup에 있는 요소의 수

getString

public String getString(int elementNum)

Specified by:

• getString in interface Choice

Parameters:

• elementNum - 쿼리되는 요소 색인

Returns:

• 요소의 문자열 부분

Throws:

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

See Also:

• getImage(int)

getImage

public Image getImage(int elementNum)

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)

Specified by:

• append in interface Choice

Parameters:

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

Returns:

• 요소의 할당된 색인

Throws:

• NullPointerException - stringPart가 null인 경우

insert

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

Specified by:

• insert in interface Choice

Parameters:

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

Throws:

• NullPointerException - stringPart가 null인 경우

delete

public void delete(int elementNum)

Specified by:

• delete in interface Choice

Parameters:

• elementNum - 삭제되는 요소 색인

Throws:

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

deleteAll

public void deleteAll()

Specified by:

• deleteAll in interface Choice

set

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

Specified by:

• set in interface Choice

Parameters:

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

Throws:

• 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()

Specified by:

• getSelectedIndex in interface Choice

Returns:

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

See Also:

• setSelectedIndex(int, boolean)

getSelectedFlags

public int getSelectedFlags(boolean[] selectedArray_return)

Specified by:

• getSelectedFlags in interface Choice

Parameters:

• selectedArray_return - 결과를 포함할 배열

Returns:

• ChoiceGroup에 선택된 요소의 수

Throws:

• NullPointerException - selectedArray_return이 null인 경우

See Also:

• setSelectedFlags(boolean[])

setSelectedIndex

public void setSelectedIndex(int elementNum,
                             boolean selected)

Specified by:

• setSelectedIndex in interface Choice

Parameters:

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

Throws:

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

See Also:

• getSelectedIndex()

setSelectedFlags

public void setSelectedFlags(boolean[] selectedArray)

Specified by:

• setSelectedFlags in interface Choice

Parameters:

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

Throws:

• NullPointerException - selectedArray가 null인 경우

See Also:

• getSelectedFlags(boolean[])

setFitPolicy

public void setFitPolicy(int fitPolicy)

Specified by:

• setFitPolicy in interface Choice

Parameters:

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

Throws:

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

Since:

• MIDP 2.0

See Also:

• getFitPolicy()

getFitPolicy

public int getFitPolicy()

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)

Specified by:

• setFont in interface Choice

Parameters:

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

Throws:

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

Since:

• MIDP 2.0

See Also:

• getFont(int)

getFont

public Font getFont(int elementNum)

Specified by:

• getFont in interface Choice

Parameters:

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

Returns:

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

Throws:

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

Since:

• MIDP 2.0

See Also:

• setFont(int elementNum, Font font)

메서드 상세

size

public int size()

Specified by:

• size in interface Choice

Returns:

• ChoiceGroup에 있는 요소의 수

getString

public String getString(int elementNum)

Specified by:

• getString in interface Choice

Parameters:

• elementNum - 쿼리되는 요소 색인

Returns:

• 요소의 문자열 부분

Throws:

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

See Also:

• getImage(int)

getImage

public Image getImage(int elementNum)

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)

Specified by:

• append in interface Choice

Parameters:

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

Returns:

• 요소의 할당된 색인

Throws:

• NullPointerException - stringPart가 null인 경우

insert

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

Specified by:

• insert in interface Choice

Parameters:

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

Throws:

• NullPointerException - stringPart가 null인 경우

delete

public void delete(int elementNum)

Specified by:

• delete in interface Choice

Parameters:

• elementNum - 삭제되는 요소 색인

Throws:

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

deleteAll

public void deleteAll()

Specified by:

• deleteAll in interface Choice

set

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

Specified by:

• set in interface Choice

Parameters:

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

Throws:

• 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()

Specified by:

• getSelectedIndex in interface Choice

Returns:

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

See Also:

• setSelectedIndex(int, boolean)

getSelectedFlags

public int getSelectedFlags(boolean[] selectedArray_return)

Specified by:

• getSelectedFlags in interface Choice

Parameters:

• selectedArray_return - 결과를 포함할 배열

Returns:

• ChoiceGroup에 선택된 요소의 수

Throws:

• NullPointerException - selectedArray_return이 null인 경우

See Also:

• setSelectedFlags(boolean[])

setSelectedIndex

public void setSelectedIndex(int elementNum,
                             boolean selected)

Specified by:

• setSelectedIndex in interface Choice

Parameters:

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

Throws:

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

See Also:

• getSelectedIndex()

setSelectedFlags

public void setSelectedFlags(boolean[] selectedArray)

Specified by:

• setSelectedFlags in interface Choice

Parameters:

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

Throws:

• NullPointerException - selectedArray가 null인 경우

See Also:

• getSelectedFlags(boolean[])

setFitPolicy

public void setFitPolicy(int fitPolicy)

Specified by:

• setFitPolicy in interface Choice

Parameters:

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

Throws:

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

Since:

• MIDP 2.0

See Also:

• getFitPolicy()

getFitPolicy

public int getFitPolicy()

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)

Specified by:

• setFont in interface Choice

Parameters:

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

Throws:

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

Since:

• MIDP 2.0

See Also:

• getFont(int)

getFont

public Font getFont(int elementNum)

Specified by:

• getFont in interface Choice

Parameters:

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

Returns:

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

Throws:

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

Since:

• MIDP 2.0

See Also:

• setFont(int elementNum, Font font)