Class List

package javax.microedition.lcdui

java.lang.Object
  |
  +--javax.microedition.lcdui.Displayable
        |
        +--javax.microedition.lcdui.Screen
              |
              +--javax.microedition.lcdui.List

설명

All Implemented Interfaces:

• Choice

implements Choice:

선택 목록을 포함하는 Screen. 대부분의 동작은 ChoiceGroup 클래스 및 해당 공통 API와 유사합니다. 특히 다른 List 유형은 Choice 인터페이스에 정의되어 있습니다. 디스플레이에 List가 있으면 사용자는 요소를 선택하고 가능한 경우 여러 요소 간을 순회하고 스크롤하여 목록과 상호 작용할 수 있습니다. 순회 및 스크롤 작업은 응용 프로그램 가시적 이벤트를 발생하지 않습니다. 시스템은 해당 CommandListener에 알려 Command가 호출될 때만 응용 프로그램에 알립니다. List 클래스는 또한 장치의 기능에 따라 특별히 호출될 수 있는 선택 명령도 지원합니다.

List 요소에 대한 선택 작업의 개념은 사용자와 List와의 상호 작용에 집중됩니다. 지정된 하드웨어 “선택” 또는 “이동” 키가 있는 장치에서는 해당 키를 사용하여 선택 작업을 구현합니다. 지정된 키가 없는 장치에서는 선택 작업을 수행할 수 있는 다른 방법을 제공해야 합니다(예: 소프트 키 사용). 유형이 다른 목록에서의 선택 작업 동작은 다음 절에 설명되어 있습니다.

List 객체는 Choice.EXCLUSIVE, Choice.MULTIPLE 및 Choice.IMPLICIT의 Choice 유형으로 작성될 수 있습니다. Choice.POPUP Choice 유형은 List 객체에서는 허용되지 않습니다.

EXCLUSIVE 및 MULTIPLE 목록에서 선택

선택 작업은 Command 객체와 연관되지 않으므로 응용 프로그램에는 레이블을 설정하거나 작업 수행 시 알림을 받을 방법이 없습니다. EXCLUSIVE 유형의 List에서 선택 작업은 대상 요소를 선택하고 이전에 선택한 요소를 선택 해제합니다. MULTIPLE 유형의 List에서 선택 작업은 대상 요소의 선택된 상태를 전환하고 다른 요소의 선택된 상태를 변경되지 않은 상태로 둡니다. 소프트 키를 사용하여 선택 작업을 구현하는 장치는 여기에 레이블을 제공해야 합니다. 레이블은 EXCLUSIVE 유형 List의 “선택” 및 MULTIPLE유형 List의 “표시” 또는 “표시 취소”와 유사한 부분이 있습니다.

IMPLICIT 목록에서 선택

선택 작업은 선택 명령으로 불리는 Command 객체와 연관되어 있습니다. 사용자가 선택 작업을 수행할 때 시스템은 List의 CommandListener에 알려 선택 명령을 호출합니다. 기본 선택 명령은 시스템이 제공한 SELECT_COMMAND 명령입니다. 응용 프로그램은 setSelectCommand 메소드를 사용하여 선택 명령을 수정할 수 있습니다. 소프트 키를 사용하여 선택 작업을 구현하는 장치는 선택 명령으로부터 레이블을 사용합니다. 선택 명령이 SELECT_COMMAND이면 장치는 SELECT_COMMAND 레이블 속성을 사용하는 대신 고유의 레이블을 제공하도록 선택할 수 있습니다. 응용 프로그램은 일반적으로 SELECT_COMMAND를 교체할 고유의 선택 명령을 제공해야 합니다. 이렇게 하면 응용 프로그램은 SELECT_COMMAND에 시스템이 제공한 레이블에 의존하는 대신 의미있는 레이블을 제공할 수 있습니다. 구현 시 List에 요소가 없는 경우 List가 비어 있으면 선택할 수 없기 때문에 선택 명령을 호출해서는 안 됩니다. 이런 경우 선택 명령이 소프트 버튼이나 메뉴에 명시적으로 표시되면 구현 시 이를 제거하거나 사용 불가능으로 해야 합니다. 일반적으로 List가 비어 있을 때 다른 명령은 호출할 수 있습니다.

IMPLICIT 목록 사용

IMPLICIT List는 작업을 List 요소로 제공하여 메뉴를 구성하는 데 사용할 수 있습니다. 응용 프로그램은 List 요소를 선택하는 데 사용되는 Command를 제공한 다음 이 Command를 선택 명령으로 사용하도록 정의합니다. 응용 프로그램은 또한 사용자가 Command를 선택하거나 활성화할 때 호출되는 CommandListener를 등록해야 합니다.

String[] elements = { … }; //Menu items as List elements List menuList = new List(“Menu”, List.IMPLICIT, elements, null); Command selectCommand = new Command(“Open”, Command.ITEM, 1); menuList.setSelectCommand(selectCommand); menuList.setCommandListener(…);

수신기는 List를 쿼리하여 어떤 요소가 선택되었는지 확인한 다음 해당 작업을 수행합니다. 명령을 선택 명령으로 설정하면 List가 잘못 동작할 수도 있습니다.

선택 명령은 선택 키를 누를 때 수행되는 기본 작업으로 간주되어야 합니다. 예를 들어, 전자 메일 헤더를 표시하는 List에는 읽기, 응답 및 삭제의 3가지 작업이 있을 수 있으며 읽기가 기본 작업으로 간주됩니다.

List list = new List(“Email”, List.IMPLICIT, headers); readCommand = new Command(“Read”, Command.ITEM, 1); replyCommand = new Command(“Reply”, Command.ITEM, 2); deleteCommand = new Command(“Delete”, Command.ITEM, 3); list.setSelectCommand(readCommand); list.addCommand(replyCommand); list.addCommand(deleteCommand); list.setCommandListener(…);

지정된 선택 키가 있는 장치에서 이 키를 누르면 readCommand가 호출됩니다. 읽기 명령은 일반 Command 명령으로도 제공되기 때문에 선택 키가 없는 장치에서도 사용자는 읽기 명령을 호출할 수 있습니다.

이러한 종류의 기본 작업은 주의해서 사용해야 하며 그 결과로 만들어진 사용자 인터페이스의 유용성을 항상 염두에 두어야 합니다. 기본 작업은 항상 특정 목록에서 가장 직관적인 작업이어야 합니다.

Since:

• MIDP 1.0

필드 요약

• static Command SELECT_COMMAND — IMPLICIT List 의 기본 선택 명령.

생성자 요약

• List ( String title, int listType) 비어 있는 새 List 를 만들고 목록의 제목과 유형을 지정합니다.
• List ( String title, int listType, String [] stringElements, Image [] imageElements) 새 List 를 만들고 제목과 List 유형 및 초기 내용으로 사용할 String 및 Image 의 배열을 지정합니다.

메서드 요약

• int append ( String stringPart, Image imagePart) — List 의 요소에 첨부합니다.
• void delete (int elementNum) — elementNum 에서 참조하는 요소를 삭제합니다.
• void deleteAll () — 이 목록에서 모든 요소를 삭제합니다.
• int getFitPolicy () — Choice 요소 내용을 사용 가능한 화면 크기에 맞추기 위한 응용 프로그램의 권장 정책을 가져옵니다.
• Font getFont (int elementNum) — 이 Choice 의 지정된 요소를 렌더링하기 위한 응용 프로그램의 기본 글꼴을 가져옵니다.
• Image getImage (int elementNum) — elementNum 에서 참조하는 요소의 Image 부분을 가져옵니다.
• int getSelectedFlags (boolean[] selectedArray_return) — List 의 상태를 쿼리하고 부울 배열 selectedArray_return 의 모든 요소 상태를 반환합니다.
• int getSelectedIndex () — List 에서 선택된 요소의 색인 번호를 반환합니다.
• String getString (int elementNum) — elementNum 에서 참조하는 요소의 String 부분을 가져옵니다.
• void insert (int elementNum, String stringPart, Image imagePart) — 요소를 지정하기 전에 List 에 요소를 삽입합니다.
• boolean isSelected (int elementNum) — 이 요소의 선택 여부를 나타내는 부울 값을 가져옵니다.
• void removeCommand ( Command cmd) — 다음과 같은 의미가 추가되고 나머지는 Displayable.removeCommand 와 동일합니다.
• void set (int elementNum, String stringPart, Image imagePart) — 요소의 이전 내용을 바꿔 elementNum 에서 참조하는 요소의 String 및 Image 부분을 설정합니다.
• void setFitPolicy (int fitPolicy) — Choice 요소 내용을 사용 가능한 화면 크기에 맞추기 위한 응용 프로그램의 기본 정책을 설정합니다.
• void setFont (int elementNum, Font font) — 이 Choice 의 지정된 요소를 렌더링하기 위한 응용 프로그램의 기본 글꼴을 설정합니다.
• void setSelectCommand ( Command command) — IMPLICIT List 선택 작업에 사용할 Command 를 설정합니다.
• void setSelectedFlags (boolean[] selectedArray) — List 의 모든 요소의 선택된 상태를 설정합니다.
• void setSelectedIndex (int elementNum, boolean selected) — 요소의 선택된 상태를 설정합니다.
• int size () — List 의 요소 수를 가져옵니다.

필드 상세

SELECT_COMMAND

public static final Command SELECT_COMMAND

• IMPLICIT List의 기본 선택 명령. IMPLICIT List를 사용하는 응용 프로그램은 setSelectCommand를 사용하여 고유의 선택 명령을 설정해야 합니다.

SELECT_COMMAND의 필드 값은 다음과 같습니다.

• label = "" (an empty string)

• type = SCREEN

• priority = 0

(유형이 ITEM이면 더 적합하지만 기록용으로 SCREEN 유형을 그대로 사용합니다.)

응용 프로그램은 SELECT_COMMAND를 인식하기 위해 이러한 값을 사용해서는 안 됩니다. 대신 Command 및 Displayable(List)의 객체 ID를 사용해야 합니다.

SELECT_COMMAND는 다른 Displayable 유형과 함께 사용된 경우 일반 Command로 처리됩니다.

List

public List(String title,
            int listType)

• 비어 있는 새 List를 만들고 목록의 제목과 유형을 지정합니다.

Parameters:

• listType - IMPLICIT, EXCLUSIVE 또는 MULTIPLE 중 하나

Throws:

• IllegalArgumentException - listType이 IMPLICIT, EXCLUSIVE 또는 MULTIPLE 중 하나가 아닌 경우

See Also:

• Choice

List

public List(String title,
            int listType,
            String[] stringElements,
            Image[] imageElements)

• 새 List를 만들고 제목과 List유형 및 초기 내용으로 사용할 String 및 Image의 배열을 지정합니다.

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

Parameters:

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

Throws:

• IllegalArgumentException - listType이 IMPLICIT, EXCLUSIVE 또는 MULTIPLE 중 하나가 아닌 경우

See Also:

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

size

public int size()

Specified by:

• size in interface Choice

Returns:

• List의 요소 수

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:

• Choice에서 선택된 요소 수

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는 선택된 상태를, false는 선택되지 않은 상태를 의미합니다.

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[])

removeCommand

public void removeCommand(Command cmd)

Overrides:

• removeCommand in class Displayable

Parameters:

• cmd - 제거되는 명령

Since:

• MIDP 2.0

setSelectCommand

public void setSelectCommand(Command command)

Parameters:

• command - IMPLICIT 목록 선택 작업에 사용할 명령, 없는 경우에는 null

Since:

• MIDP 2.0

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)

생성자 상세

List

public List(String title,
            int listType)

• 비어 있는 새 List를 만들고 목록의 제목과 유형을 지정합니다.

Parameters:

• listType - IMPLICIT, EXCLUSIVE 또는 MULTIPLE 중 하나

Throws:

• IllegalArgumentException - listType이 IMPLICIT, EXCLUSIVE 또는 MULTIPLE 중 하나가 아닌 경우

See Also:

• Choice

List

public List(String title,
            int listType,
            String[] stringElements,
            Image[] imageElements)

• 새 List를 만들고 제목과 List유형 및 초기 내용으로 사용할 String 및 Image의 배열을 지정합니다.

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

Parameters:

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

Throws:

• IllegalArgumentException - listType이 IMPLICIT, EXCLUSIVE 또는 MULTIPLE 중 하나가 아닌 경우

See Also:

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

size

public int size()

Specified by:

• size in interface Choice

Returns:

• List의 요소 수

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:

• Choice에서 선택된 요소 수

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는 선택된 상태를, false는 선택되지 않은 상태를 의미합니다.

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[])

removeCommand

public void removeCommand(Command cmd)

Overrides:

• removeCommand in class Displayable

Parameters:

• cmd - 제거되는 명령

Since:

• MIDP 2.0

setSelectCommand

public void setSelectCommand(Command command)

Parameters:

• command - IMPLICIT 목록 선택 작업에 사용할 명령, 없는 경우에는 null

Since:

• MIDP 2.0

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:

• List의 요소 수

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:

• Choice에서 선택된 요소 수

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는 선택된 상태를, false는 선택되지 않은 상태를 의미합니다.

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[])

removeCommand

public void removeCommand(Command cmd)

Overrides:

• removeCommand in class Displayable

Parameters:

• cmd - 제거되는 명령

Since:

• MIDP 2.0

setSelectCommand

public void setSelectCommand(Command command)

Parameters:

• command - IMPLICIT 목록 선택 작업에 사용할 명령, 없는 경우에는 null

Since:

• MIDP 2.0

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)