List

Класс List (список) по назначению очень похож на класс Choice, но предоставляет пользователю не раскрывающийся список, а окно с полосами прокрутки, внутри которого находятся пункты выбора. Любой из этих пунктов можно выбрать двойным щелчком мыши или, указав на него мышью, нажать клавишу <Enter>. Причем можно сделать так, что станет возможным выбор нескольких пунктов одновременно.

Создание объекта класса List может происходить двумя способами. Вы можете создать пустой список и добавлять в него пункты, вызывая метод addItem. При этом размер списка будет расти при добавлении пунктов. Другой способ позволяет сразу ограничить количество видимых в окне списка пунктов. Остальные пункты выбора можно увидеть, прокрутив список. Вот пример для обоих способов:

// Создание списка без ограничения // размера List list1 = new List(); list.addItem("First"); list.addItem("Second"); list.addItem("Third"); list.addItem("Forth"); // Создание списка, ограниченного // размером в два пункта выбора List list2 = new List(2,true); list.addItem("First"); list.addItem("Second"); list.addItem("Third"); list.addItem("Forth");

Полезные методы класса List:

getItem(int) - считать текст пункта выбора;

countItems() - посчитать количество пунктов выбора в списке;

replaceItem(String, int) - заменить элемент выбора в указанной позиции;

clear() - очистить список;

delItem(int) - убрать из списка определенный пункт;

delItems(int, int) - убрать элементы выбора с номерами, входящими в интервал от номера, указанного первым параметром, до номера, указанного вторым параметром;

getSelectedIndex() - узнать порядковый номер выделенного пункта; если возвращается -1, то выбрано несколько пунктов;

getSelectedIndexes() - возвратить массив индексов выделенных пунктов;

getSelectedItem() - прочитать текст выделенного пункта выбора;

getSelectedItems() - возвратить массив строк текста выделенных пунктов;

select(int) - выделить пункт с определенным номером;

deselect(int) - снять выделение с определенного пункта;

isSelected(int) - возвратить значение true, если пункт с указанным номером выделен, иначе возвратить false;

getRows() - возвратить количество видимых в списке строк выбора;

allowsMultipleSelections() - возвратить true, если список позволяет множественный выбор;

setMultipleSelections() - включить режим разрешения множественного выбора;

makeVisible(int) - сделать элемент с определенным номером видимым в окне списка;

getVisibleIndex() - возратить индекс элемента выбора, который последним после вызова метода makeVisible() стал видимым в окне списка.

Содержание раздела

---