Списки класса List

На базе класса List вы можете сделать список другого типа, который допускает выбор не только одного, но и нескольких элементов. В отличие от списка, созданного на базе класса Choice, список класса List может занимать прямоугольную область, в которой помещаются сразу несколько элементов. Этот список всегда находится в раскрытом состоянии (рис. 5).

Рис. 5. Список класса List, все элементы которого помещаются в окне списка

Если размеры окна списка класса List недостаточны для того чтобы вместить в себя все элементы, в правой части окна списка автоматически создается полоса просмотра, с помощью которой можно пролистать весь список (рис. 6).

Рис. 6. Список класса List с полосой просмотра

Описание класса List

В классе List определено два конструктора и довольно много различных методов. Ниже мы привели краткое описание класса List:

Конструкторы

Конструктор без параметров

public List();

Конструктор, позволяющий указать количество отображаемых строк и флаг одновременного выбора нескольких элементов

public List(int rows, 
  boolean multipleSelections);

Методы

• addItem

Добавление элемента в список

public void addItem(String item);

Добавление элемента в список с указанием номера позиции

public void addItem(String item, int index);

• addNotify

Вызов метода createList

public void addNotify();

• allowsMultipleSelections

Переключение списка в режим, при котором возможно выбирать одновременно несколько элементов

public boolean allowsMultipleSelections();

• clear

Удаление из списка всех элементов

public void clear();

• countItems

Определение количества элементов в списке

public int countItems();

• delItem

Удаление элемента из заданной позиции

public void delItem(int position);

• delItems

Удаление нескольких элементов

public void delItems(int start, int end);

• deselect

Отмена выделения элемента с заданной позицией

public void deselect(int index);

• getItem

Получение строки, связанной с элементом, по позиции этого элемента

public String getItem(int index);

• getRows

Определение количества элементов, которые видны в окне списка

public int getRows();

• getSelectedIndex

Определение номера выделенного элемента

public int getSelectedIndex();

• getSelectedIndexes

Определение номеров выделенных элементов

public int[] getSelectedIndexes();

• getSelectedItem

Получение текстовой строки, связанной с выделенным элементом

public String getSelectedItem();

• getSelectedItems

Получение ссылки на массив строк, связанных с выделенными элементами

public String[] getSelectedItems();

• getVisibleIndex

Определение номера элемента массива, который был сделан в последний раз выделенным с помощью метода makeVisible

public int getVisibleIndex();

• isSelected

Проверка, является ли выделенной строка с заданным номером

public boolean isSelected(int index);

• makeVisible

Выполняется свертка элементов списка таким образом, чтобы элемент с заданным номером стал видимым

public void makeVisible(int index);

• minimumSize

Минимальные размеры области, необходимые для отображения списка

public Dimension minimumSize();

Минимальные размеры области, необходимые для отображения списка с заданным количеством строк

public Dimension minimumSize(int rows);

• paramString

Получение строки параметров

protected String paramString();

• preferredSize

Предпочтительные размеры области, необходимые для отображения списка

public Dimension preferredSize();

Предпочтительные размеры области, необходимые для отображения списка с заданным количеством строк

public Dimension preferredSize(int rows);

• removeNotify

Извещение об уничтожении узла

public void removeNotify();

• replaceItem

Замещение элемента списка с заданным номером

public void replaceItem(String newValue, 
  int index);

• select

Выделение элемента с заданным номером

public void select(int index);

• setMultipleSelections

Установка или сброс режима одновременного выделения нескольких строк

public void setMultipleSelections(boolean v);

Создание списка класса List

Процесс создания списка класса List несложен:

List chBackgroundColor;
chBackgroundColor = new List(6, false);

При создании списка вы передаете конструктору количество одновременно отображаемых строк и флаг разрешения одновременного выбора нескольких строк. Если значение этого флага равно true, пользователь сможет выбирать из списка одновременно несколько строк, а если false - только одну строку.

Для наполнения списка вы можете использовать уже знакомый вам метод addItem:

chBackgroundColor.addItem("Yellow");
chBackgroundColor.addItem("Green");
chBackgroundColor.addItem("White");

Список класса List добавляется к окну аплета методом add:

add(chBackgroundColor);

Кратко остановимся на нескольких методах класса List.

Если вы разрешили пользователю выбирать из списка одновременно несколько элементов, то для получения ссылки на массив выбранных элементов вам пригодятся методы getSelectedItems и getSelectedIndexes:

public String[] getSelectedItems();	
public int[] getSelectedIndexes();

С помощью метода setMultipleSelections вы можете динамически включать или выключать режим одновременного выбора нескольких элементов.

В некоторых случаях вам может пригодиться метод clear, удаляющий все элементы из списка:

public void clear();

Методика использования других методов очевидна из краткого описания класса List, приведенного в нашей статье.

Обработка событий от списка класса List

В отличие от списка класса Choice, для выбора строки (или нескольких строк) из списка класса List, пользователь должен сделать двойной щелчок левой клавишей мыши по выделенному элементу (или элементам, если выделено несколько элементов). При этом событие можно обработать переопределенным методом action, как мы это делали для списка класса Choice.

Однако список класса List создает события не только при двойном щелчке, но и при выделении или отмены выделения элементов, сделанном пользователем одинарным щелчком клавиши мыши. Аплет может перехватывать и обрабатывать такие события, переопределив метод handleEvent.