Флажок


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

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

Значения целочисленных переменных и параметров удобнее изменять с помощью бегунков. Управлять же значениями переменных типа String и double лучше всего с помощью текстовых полей.

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

Свойства

Основные

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

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

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

Метка – Текстовая метка, отображаемая рядом с флажком.

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

Значение по умолчанию – [Видно, если не установлен флажок Связать с] Логическое выражение, определяющее, выбран ли флажок по умолчанию или нет. Если флажок связан с какой-либо переменной или параметром, то в качестве значения по умолчанию будет использовано начальное значение этой переменной или параметра.

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

Действие

Код, который будет выполняться при изменении состояния флажка. Текущее состояние флажка доступно как value  (локальная переменная типа boolean: равна true, если флажок выбран и false - если нет).

Внешний вид

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

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

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

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

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

Местоположение и размер

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

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

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

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

Специфические

Видимость – Флажок будет виден, если заданное здесь выражение будет истинно (true), в противном случае он отображаться не будет.

Количество – Количество экземпляров данного элемента управления. Если вы оставите это поле пустым, то будет создан только один такой элемент управления.

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

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

Функции

Установка/сброс флажка

Функция

Описание

boolean isSelected()

Возвращает состояние флажка. 

Возвращает true, если флажок в данный момент выбран, либо же false, если флажок сброшен.

void setSelected
(boolean yes)

Задает состояние флажка.
При этом заданное пользователем действие не выполняется.

Параметр:
yes - если true, то флажок будет выбран, в противном случае - сброшен.

void setSelected
(boolean yes,
boolean callAction)

Задает состояние флажка.
Выполняет действие, заданное пользователем, если параметр callAction равен true.

Параметры:
yes - если true - флажок выбран, в противном случае - сброшен.
callAction - если true, то действие, заданное пользователем , будет выполнено.

void setValueToDefault()

Устанавливает заданное по умолчанию состояние в качестве текущего состояния флажка.
При этом заданное пользователем действие не выполняется.

Управление доступом

Функция

Описание

boolean isEnabled()

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

void setEnabled
(boolean yes)

Делает элемент управления активным или недоступным (в зависимости от значения аргумента функции).

Параметр:
yes - если true, то элемент управления будет активен; если false - то недоступен. 

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

Функция

Описание

void action()

Выполняет действие, заданное пользователем для этого элемента управления (в его свойстве Действие).

Текст метки

Функция

Описание

String getText()

Возвращает текст метки, отображаемой на флажке

void setText(Object text)

Задает текст метки, отображаемоей на флажке.

Параметр:
text - новый текст метки

Местоположение

Функция

Описание

double getX()

Возвращает координату X элемента управления (если точнее, то координату X его верхнего левого угла).

double getY()

Возвращает координату Y элемента управления (если точнее, то координату Y его верхнего левого угла).

void setX(double x)

Задает новую координату X.

Параметр:
x - новое значение координаты X

void setY(double y)

Задает новую координату Y.

Параметр:
y - новое значение координаты Y

void setPos(double x, double y)

Задает новое местоположение элемента управления.

Параметры:
x - новое значение координаты X
y - новое значение координаты Y

Видимость

Функция

Описание

boolean isVisible()

Возвращает видимость элемента управления. 

Если возвращает true, то элемент управления виден; если false - то нет.

void setVisible
(boolean v)

Задает видимость элемента управления.

Параметр:
v - видимость: если true, то элемент управления будет виден, если false - то нет.


См. также

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