Список

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

Вы можете также связать этот элемент управления с переменной или параметром типа String. При этом выбор того или иного значения в списке будет присваивать выбранное значение связанной со списком переменной.

1. Перетащите элемент Список  из палитры Элементы управления в то место графического редактора, где Вы хотите его нарисовать.
2. Перейдите на страницу Основные панели Свойства.
3. В поле Значение по умолчанию Вы можете ввести имя элемента, который будет выбран в списке по умолчанию (или выражение, возвращающее имя этого элемента). Например, Вы задали Элементы красный и синий. Чтобы сделать элемент синий выбранным по умолчанию, напишите здесь его имя в кавычках: "синий".
4. Если Вы хотите связать список с переменной или параметром типа String (то есть, присваивать этой переменной имя выбранного в текущий момент элемента списка), установите флажок Связать с и введите имя соответствующей переменной или параметра в расположенном справа поле.
5. Если же Вы хотите, чтобы при выборе пользователем в списке другого значения производилось какое-то другое, более сложное действие, введите код, который Вы хотели бы выполнять в таком случае, в поле Действие (имя выбранного в данный момент времени элемента доступно здесь как value (локальная переменная типа String)).

Основные свойства

Имя – Имя списка. Имя используется для идентификации элемента и доступа к нему из кода.

Отображать имя – Если опция выбрана, то имя списка будет отображаться в графическом редакторе.

Исключить – Если опция выбрана, то список будет исключен из модели.

На верхнем уровне – Если опция выбрана, то список будет виден на презентации класса, в который будет вложен данный активный объект.

Значок – Если опция выбрана, то список будет считаться частью значка класса активного объекта.

Элементы – Здесь Вы задаете элементы, которые появятся в списке. В строках таблицы задаются имена элементов. Чтобы удалить запись из таблицы, выберите соответствующую строку и щелкните по кнопке  . Поскольку порядок отображения записей важен, Вы можете изменять его с помощью кнопок  и , расположенных справа от таблицы.

Выбор нескольких элементов – Если опция выбрана, то во время выполнения модели пользователь сможет одновременно выбирать сразу несколько элементов из списка.

Связать с – Если Вы хотите связать значение списка с переменной или параметром типа String (то есть, присваивать этой переменной имя выбранного в текущий момент элемента списка), установите этот флажок и введите имя соответствующей переменной или параметра в расположенном справа поле.

Значение по умолчанию – [Видно, если не установлен флажок Связать с] Выражение, возвращающее значение типа String - имя элемента, который будет выбран в списке по умолчанию. Например, Вы задали Элементы красный и синий. Чтобы сделать элемент синий выбранным по умолчанию, напишите здесь его имя в кавычках: "синий"

Доступность – Логическое выражение, определяющее, доступен ли элемент управления или нет.

Действие – Код, который будет выполняться при выборе другого элемента (элементов). Имя выбранного в данный момент времени элемента доступно здесь как value (локальная переменная типа String). Если у списка разрешен Выбор нескольких элементов, то переменная value будет хранить первый выбранный элемент, а переменная values - массив String[], содержащий имена всех выбранных элементов.

Дополнительные свойства

Цвет текста – Задает цвет текста, отображаемого в списке. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета.

Шрифт – Задает тип шрифта текста, отображаемого в списке. В расположенном справа поле Вы можете выбрать размер шрифта.

Курсив – Если опция выбрана, то текст будет выделен курсивом.

Полужирный – Если опция выбрана, то текст будет выделен полужирным шрифтом.

Цвет фона – Задает цвет фона списка. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета.

X – X-координата верхнего левого угла списка.

Y – Y-координата верхнего левого угла списка.

Ширина – Ширина списка (в пикселах).

Высота – Высота списка (в пикселах).

Разрешить программное управление – Если опция выбрана, то элемент управления будет представлен в модели как Java объект, и будет доступен из кода по имени. С помощью программного интерфейса Вы сможете изменять визуальные свойства элемента управления и тем самым управлять ее внешним видом во время выполнения модели.

Динамические свойства

Имя	Тип	Описание
Количество	int	Количество экземпляров данного элемента управления. Если Вы оставите это поле пустым, то будет создан только один такой элемент управления.
Видимость	boolean	Видимость элемента управления. Элемент управления будет виден, если заданное здесь выражение будет истинно (true), в противном случае он отображаться не будет.
X	double	X-координата верхнего левого угла элемента управления.
Y	double	Y-координата верхнего левого угла элемента управления.
Ширина	int	Ширина элемента управления (в пикселах).
Высота	int	Высота элемента управления (в пикселах).

См. также

 Перемещение фигуры

 Изменение размера фигуры

 Управление видимостью фигур

 Справочник классов: Класс ShapeListBox