javax.microedition.lcdui
Class List

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

All Implemented Interfaces:

Choice

public class List

extends Screen

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

Field Summary

static Command

SELECT_COMMAND IMPLICIT List의 기본 선택 명령.

Fields inherited from interface javax.microedition.lcdui.Choice

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

Constructor Summary

List(String title, int listType)
비어 있는 새 List를 만들고 목록의 제목과 유형을 지정합니다.

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

Method Summary

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의 요소 수를 가져옵니다.

Methods inherited from class javax.microedition.lcdui.Displayable

addCommand, getHeight, getTicker, getTitle, getWidth, isShown, setCommandListener, setTicker, setTitle, sizeChanged

Methods inherited from class java.lang.Object

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

Field Detail

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로 처리됩니다.

Constructor Detail

List

public List(String title,
            int listType)

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

Parameters:

title - 화면 제목(Displayable 참조)

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:

title - 화면 제목(Displayable 참조)

listType - IMPLICIT, EXCLUSIVE 또는 MULTIPLE 중 하나

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

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

Throws:

NullPointerException - stringElements가 null인 경우

NullPointerException - stringElements 배열에 null 요소가 포함된 경우

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

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

See Also:

Choice.EXCLUSIVE, Choice.MULTIPLE, Choice.IMPLICIT

Method Detail

size

public int size()

List의 요소 수를 가져옵니다.

Specified by:

size in interface Choice

Returns:

List의 요소 수

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)

List의 요소에 첨부합니다.

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)

요소를 지정하기 전에 List에 요소를 삽입합니다.

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

이 목록에서 모든 요소를 삭제합니다.

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

List에서 선택된 요소의 색인 번호를 반환합니다.

Specified by:

getSelectedIndex in interface Choice

Returns:

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

See Also:

setSelectedIndex(int, boolean)

getSelectedFlags

public int getSelectedFlags(boolean[] selectedArray_return)

List의 상태를 쿼리하고 부울 배열 selectedArray_return의 모든 요소 상태를 반환합니다.

Specified by:

getSelectedFlags in interface Choice

Parameters:

selectedArray_return - 결과를 포함할 배열

Returns:

Choice에서 선택된 요소 수

Throws:

IllegalArgumentException - selectedArray_return이 목록 크기보다 짧은 경우

NullPointerException - selectedArray_return이 null인 경우

See Also:

setSelectedFlags(boolean[])

setSelectedIndex

public void setSelectedIndex(int elementNum,
                             boolean selected)

요소의 선택된 상태를 설정합니다.

Specified by:

setSelectedIndex in interface Choice

Parameters:

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

selected - 요소 상태, 여기서 true는 선택된 상태를, false는 선택되지 않은 상태를 의미합니다.

Throws:

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

See Also:

getSelectedIndex()

setSelectedFlags

public void setSelectedFlags(boolean[] selectedArray)

List의 모든 요소의 선택된 상태를 설정합니다.

Specified by:

setSelectedFlags in interface Choice

Parameters:

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

Throws:

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

NullPointerException - selectedArray가 null인 경우

See Also:

getSelectedFlags(boolean[])

removeCommand

public void removeCommand(Command cmd)

다음과 같은 의미가 추가되고 나머지는 Displayable.removeCommand와 동일합니다.

제거할 명령이 선택 명령인 경우 List는 선택 명령이 없는 것으로 설정되고 명령이 List에서 제거됩니다.

다음 코드는

     // Command c is the select command on List list
     list.removeCommand(c);     

다음 코드와 동일합니다.

     // Command c is the select command on List list
     list.setSelectCommand(null);
     list.removeCommand(c);     

Overrides:

removeCommand in class Displayable

Parameters:

cmd - 제거되는 명령

Since:

MIDP 2.0

setSelectCommand

public void setSelectCommand(Command command)

IMPLICIT List 선택 작업에 사용할 Command를 설정합니다. 기본적으로 목록을 암시적으로 선택하면 미리 정의된 List.SELECT_COMMAND가 사용됩니다. 이 동작은 적절한 매개 변수 값과 함께 List.setSelectCommand() 메소드를 호출하여 무시할 수 있습니다. null 참조가 전달되면 이 List 내용에 적절한 "선택" 작업이 없음을 나타냅니다.

명령 객체에 대한 참조가 전달되고 List.SELECT_COMMAND 특별 명령이 아니고 현재 이 List 객체에 없으면, 명령 객체는 선택 명령을 만든 명령 전에 addCommand(command)가 호출된 것처럼 이 List에 추가됩니다. 이는 사용자가 이 List의 요소에 대한 "선택"을 수행할 때 이 명령이 호출됨을 나타냅니다.

선택 명령은 현재 선택된 객체에서 작동함을 나타내기 위해 ITEM 명령 유형이어야 합니다. 명령이 다른 유형인 경우에도 오류는 아닙니다. (List.SELECT_COMMAND는 기록용으로 SCREEN 유형을 사용합니다.) 사용자 인터페이스 내의 표시 및 배치를 위해 구현 시 선택 명령을 ITEM 항목인 것처럼 처리할 수 있습니다.

나중에 선택 명령이 removeCommand()를 사용해 List에서 제거되면 List는 List.setSelectCommand(null)이 호출된 것처럼 선택 명령이 없는 것으로 설정됩니다.

기본 동작은 List.SELECT_COMMAND 인자와 함께 setSelectCommand()를 명시적으로 호출하여 다시 구성할 수 있습니다.

List 유형이 IMPLICIT가 아니면 이 메소드는 유효하지 않습니다.

Parameters:

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

Since:

MIDP 2.0

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)