Использование списков

Класс List обеспечивает компактный многоэлементный список со множественным выбором и прокруткой. В отличие от объекта типа Choice, который показывает в меню только один выбранный элемент, List-объект может быть сконструирован так, чтобы отображать любое число элементов выбора в видимом окне. Его можно создать так, чтобы разрешить множественный выбор. List содержит следующие конструкторы:

List ()

List(int numRows)

List(int numRows, boolean multipleSelect)

Первая форма создает элемент управления List, который позволяет выбирать только один элемент. Во второй форме значение параметра numRows определяет число строк в списке, которые будут всегда видимы в панели списка (другие могут прокручиваться в панели по мере необходимости). В третьей форме, если параметр multipleSelect равен true, то пользователь может выбирать два или несколько элементов одновременно. Если его значение — false, то можно выбрать только один элемент.

Чтобы добавить элемент выбора к списку, вызывайте метод add(), который имеет следующие формы:

void add (String name)

void add (String name, int index)

Здесь name — имя элемента, добавляемого к списку. Первая форма добавляет элементы к концу списка. Вторая — добавляет элементы по индексу (номеру), указываемому параметром index. Индексация начинается с нуля. Чтобы добавить элемент в конец списка, нужно указать индекс, равный —1.

Для списков, которые допускают только одиночный выбор, можно определять, какой элемент выбран в текущий момент, если вызвать метод getSelectedItem() или getSelectedIndex(). Форматы этих методов:

String getSelectedItem()

int getSelectedIndex()

Метод getSelectedItem() возвращает строку, содержащую имя элемента. Если выбран больше чем один элемент или если никакого выбора еще не было сделано, возвращается null (пустой указатель). Метод getSelectedIndex() возвращает индекс элемента. Первый элемент имеет индекс 0. Если выбрано больше одного элемента, или если никакого выбора еще не было сделано, возвращается -1.

Чтобы определить текущие выбранные элементы для списков, которые допускают множественный выбор, нужно использовать метод getSelectedItems() или getSelectedIndexes() с форматами:

String[ ] getSelectedItems()

int[] getSelectedIndexes()

getSelectedItems() возвращает массив, содержащий имена текущих выбранных элементов. getSelectedIndexes() возвращает массив, содержащий индексы текущих выбранных элементов.

Для определения количества элементов в списке вызывайте метод getItemCount(). Можно устанавливать текущий выбранный элемент, используя метод select() с отсчитываемым от нуля целым индексом. Форматы этих методов:

int getItemGount()

void select(int index)

Зная индекс, можно получить имя, связанное с элементом с этим индексом, вызывая метод getItem(), который имеет следующую форму:

String getItem(int index)

Здесь index — указывает индекс (номер) желательного элемента.