Кнопка


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

Простая демо модель: Buttons Change Parameter Value

 Чтобы добавить кнопку

  1. Перетащите элемент Кнопка  из палитры Элементы управления в то место графического редактора, куда вы хотите добавить кнопку.

Свойства

Основные

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

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

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

Метка – Текстовая метка, отображаемая на кнопке.

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

Действие

Код, который будет выполняться по нажатию на кнопку.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Функции

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

Функция

Описание

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

Размер кнопки

Функция

Описание

double getWidth()

Возвращает ширину кнопки в пикселах.

double getHeight()

Возвращает высоту кнопки в пикселах.

void setWidth(double width)

Устанавливает ширину элемента равной параметру width.

void setHeight(double height)

Устанавливает высоту элемента равной параметру height.

Видимость

Функция

Описание

boolean isVisible()

Возвращает видимость кнопки. 

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

void setVisible
(boolean v)

Задает видимость кнопки.

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


См. также

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