Текстовое поле является простейшим текстовым элементом управления, позволяющим пользователю вводить небольшие объемы текста.
Вы можете также связать этот элемент управления с переменной или параметром типа String, double или int. При этом при введении пользователем в поле другого значения оно будет присваиваться связанной с этим текстовым полем переменной/параметру.
В некоторых случаях более удобно изменять значения целочисленных (типа int) переменных или параметров с помощью бегунков. Управлять же значениями логических переменных типа boolean лучше всего с помощью флажков.
Взгляните на эту демонстрационную модель. В этой простой процессной модели показывается, как связать текстовое поле с параметром интенсивности прибытия агентов rate блока библиотеки Source.
Демо модель: Edit Box Linked To Parameter Of Flowchart Block
Имя – Имя текстового поля. Имя используется для идентификации элемента и доступа к нему из кода.
Исключить – Если опция выбрана, то элемент управления будет исключен из модели.
Отображать на верхнем агенте – Если опция выбрана, то элемент управления будет виден на презентации типа агента, в который будет вложен данный агент.
Связать с – Если вы хотите связать текстовое поле с переменной или параметром (то есть, присваивать этой переменной текущее содержимое этого поля), установите этот флажок и введите имя соответствующей переменной или параметра в расположенном справа поле.
Минимальное значение – [Доступно, если установлен флажок Связать с и тип связанной с полем переменной - int или double] Минимальное значение, которое может быть введено в текстовом поле (нижняя граница диапазона значений текстового поля).
Максимальное значение – [Доступно, если установлен флажок Связать с и тип связанной с полем переменной - int или double] Максимальное значение, которое может быть введено в текстовом поле (верхняя граница диапазона значений текстового поля).
Значение по умолчанию – [Видно, если не установлен флажок Связать с] Выражение, возвращающее значение типа String - текст, который будет отображаться в текстовом поле по умолчанию.
Доступность – Логическое выражение, определяющее, доступен ли элемент управления или нет.
Код, который будет выполняться при изменении текста, содержащегося в поле. Текущее содержимое поля доступно здесь как value (локальная переменная типа String).
Цвет фона – Задает цвет фона текстового поля. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета.
Цвет текста
– Задает цвет текста, отображаемого в поле. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога
Цвета.
Шрифт – Задает тип шрифта для текста, отображаемого в поле. В расположенном справа поле вы можете выбрать размер шрифта.
Курсив – Если опция выбрана, то отображаемый в поле текст будет выделен курсивом.
Полужирный – Если опция выбрана, то отображаемый в поле текст будет выделен полужирным шрифтом.
Уровень – Уровень, на котором расположен этот элемент.
X – X-координата верхнего левого угла текстового поля.
Y – Y-координата верхнего левого угла текстового поля.
Ширина – Ширина текстового поля (в пикселах).
Высота – Высота текстового поля (в пикселах).
Видимость – Текстовое поле будет видно, если заданное здесь выражение будет истинно (true), в противном случае оно отображаться не будет.
Количество – Количество экземпляров данного элемента управления. Если вы оставите это поле пустым, то будет создан только один такой элемент управления.
Отображать имя – Если опция выбрана, то имя элемента будет отображаться в графическом редакторе.
Значок – Если опция выбрана, то элемент управления будет считаться частью значка типа агента.
Функция |
Описание |
double getDoubleValue() |
Возвращает текущее значение типа double, отображаемое в текстовом поле в данный момент. Если текущее значение не является числом, то функция выдает ошибку. |
int getIntValue() |
Возвращает текущее значение типа int, отображаемое в текстовом поле в данный момент. Если текущее значение не является числом, то функция выдает ошибку. |
String getText() |
Возвращает текст, отображаемый в текстовом поле в текущий момент времени. |
Функция |
Описание |
void setText |
Задает новый текст. При этом заданное пользователем действие не выполняется. Если текстовое поле связано с численным параметром или переменной, и новое значение будет лежать за пределами допустимого диапазона значений, то в качестве нового значения будет принято ближайшее допустимое значение.
Параметр: |
void setText |
Задает новый текст. При этом если значение аргумента функции callAction равно true, то выполнится заданное пользователем действие. Если текстовое поле связано с численным параметром или переменной, и новое значение будет лежать за пределами допустимого диапазона значений,то в качестве нового значения будет принято ближайшее допустимое значение. |
void setText |
Задает новое численное значение (если текстовое поле связано с параметром/переменной типа int или double). При этом заданное пользователем действие не выполняется. |
void setText |
Задает новое численное значение (если текстовое поле связано с параметром/переменной типа int или double). При этом если значение аргумента функции callAction равно true, то выполнится заданное пользователем действие.
Параметры: |
void setValueToDefault() |
Устанавливает заданный по умолчанию текст в качестве текущего значения текстового поля. При этом заданное пользователем действие не выполняется. |
Функция |
Описание |
double getMin() |
Возвращает минимальное значение, которое пользователь сможет ввести в текстовом поле. |
double getMax() |
Возвращает максимальное значение, которое пользователь сможет ввести в текстовом поле. Эту функцию можно использовать только тогда, когда текстовое поле связано с параметром/переменной типа int или double. |
void setRange (double min, double max) |
Задает минимальное и максимальные значения, которые пользователь сможет ввести в текстовое поле. Эту функцию можно использовать только тогда, когда текстовое поле связано с параметром/переменной типа int или double. При этом заданное пользователем действие не выполняется.
Параметры: |
void setRange(double min, double max,
|
Задает минимальное и максимальные значения, которые пользователь сможет ввести в текстовое поле. Эту функцию можно использовать только тогда, когда текстовое поле связано с параметром/переменной типа int или double. При этом если значение аргумента функции callAction равно true, то выполнится заданное пользователем действие.
Параметры: |
Функция |
Описание |
boolean isEnabled() |
Проверяет, доступен ли элемент управления в текущий момент времени. Возвращает true, если элемент доступен (и вы можете менять его состояние), либо же false, если элемент недоступен. |
void setEnabled |
Делает элемент управления активным или недоступным (в зависимости от значения аргумента функции).
Параметр: |
Функция |
Описание |
void action() |
Выполняет действие, заданное пользователем для этого элемента управления (в его свойстве Действие). |
Функция |
Описание |
double getX() |
Возвращает координату X элемента управления (если точнее, то координату X его верхнего левого угла). |
double getY() |
Возвращает координату Y элемента управления (если точнее, то координату Y его верхнего левого угла). |
void setX(double x) |
Задает новую координату X.
|
void setY(double y) |
Задает новую координату Y.
|
void setPos(double x, double y) |
Задает новое местоположение элемента управления.
Параметры: |
Функция |
Описание |
void setBackgroundColor |
Задает новый фоновый цвет. |
void setTextColor |
Задает новый цвет для отображаемого в текстовом поле текста.
Параметр: |
Функция |
Описание |
boolean isVisible() |
Возвращает видимость элемента управления. Если возвращает true, то элемент управления виден; если false - то нет. |
void setVisible |
Задает видимость элемента управления.
Параметр: |