Java руководство для начинающих - Шилдт Герберт (2012)

где Ie обозначает ссылку на объект, сформировавший событие. И хотя в самом классе ListSelectionEvent определен ряд методов, для выяснения того, что же произошло со списком, обычно приходится опрашивать сам объект типа JList. Класс ListSelectionEvent также относится к пакету j avax. swing. event.

По умолчанию компонент JList дает пользователю возможность выбрать несколько элементов из списка. Изменить такое поведение можно, вызвав метод setSelectionMode (), определенный в классе JList. Этот метод объявляется так:

void setSelectionMode(int режим)

где параметр режим задает порядок выбора элементов из списка. Значение этого параметра должно совпадать с одной из приведенных ниже констант, определенных в интерфейсе ListSelectionModel, входящем в пакет javax. swing.

SINGLE_SELECTION

SINGLE_INTERVAL_SELECTION

MULTIPLE_INTERVAL_SELECTION

По умолчанию устанавливается режим MULTIPLE_INTERVAL_SELECTION, и пользователь может выбирать ряд элементов из списка через несколько промежутков. В режиме SINGLE_INTERVAL_SELECTI0N можно выбирать ряд элементов из списка только через один промежуток. А в режиме SINGLE SELECTION каждый раз можно выбрать только один элемент из списка. Очевидно, что единственный элемент может быть выбран из списка и в двух других режимах, где допускается также выбирать одновременно целый ряд элементов.

Индекс первого элемента, выбранного из списка, а в режиме SINGLE SELECTION — это индекс единственного выбранного элемента, можно получить, вызвав метод getSelectedlndex (). Ниже показано, каким образом он объявляется,

int getSelectedlndex()

Индексирование начинается с нуля. Так, если выбран первый элемент в списке, этот метод возвращает значение 0. Если же ни один из элементов не выбран, возвращается значение -1.

Получить массив, содержащий все выбранные из списка элементы, можно, вызвав метод getSelectedlndices():

int[] getSelectedlndices()

В возвращаемом массиве индексы расположены по возрастающей. Если же получен массив нулевой длины, это означает, что ни один из элементов не выбран из списка.

Ниже приведен пример программы, демонстрирующий применение простого компонента JList, содержащего список имен. Всякий раз, когда пользователь выбирает имя из списка, формируется событие ListSelectionEvent, которое обрабатывается методом valueChanged (), объявленным в интерфейсе ListSelectionListener. Этот метод определяет индекс выбранного элемента и отображает соответствующее имя. Окно, отображаемое на экране при выполнении данной программы, приведено на рис. 15.5.

// Демонстрация простого компонента JList.

// Для компиляции этой программы требуется JDK 7

// или более поздняя версия данного комплекта.

import javax.swing.*;

import javax.swing.event.*;

import j ava.awt.*;

import java.awt.event.*;

class ListDemo implements ListSelectionListener {

JList<String> jlst;

JLabel jlab;

JScrollPane jscrip;

// создать массив имен

String names[] = { "Sherry", "Jon", "Rachel", // Этот массив имен

"Sasha", "Josselyn", "Randy", // будет отображаться

"Tom", "Mary", "Ken", // списком в компоненте JList.

"Andrew", "Matt", "Todd" };

ListDemo() {

// создать новый контейнер JFrame

JFrame jfrm = new JFrame("JList Demo");

// установить диспетчер компоновки FlowLayout

jfrm.setLayout(new FlowLayout());

// задать исходные размеры рамки окна

jfrm.setSize(200, 160);

// завершить программу после закрытия окна

jfrm.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

// создать компонент JList

jlst = new JList<String>(names); // Создание списка имен.

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

// Переход в режим выбора элементов из списка по одному.