CheckBox

CheckBox - элемент управления, предназначенный для выбора логического значения (true или false).

Свойства

id

Идентификатор контрола.

Отнаследовано от Control.

hint

Всплывающая подсказка, которая появляется при наведении на контрол.

Отнаследовано от Control.

tags

Позволяет объединять контролы в группы, возвращает массив имен.

Отнаследовано от Control.

captionWidth

Ширина заголовка в колонках (для Bootstrap-верстки).

отнаследовано от Control

editorWidth

Ширина контрола в колонках (для Bootstrap-верстки).

отнаследовано от Control

captionTextAlign

тип	значение по умолчанию	допустимые значения
string	left	left/right

Выравнивание текста заголовка контрола (доступно с версии 3.26.0)

denyRoles

Список ролей без прав на данный элемент.

Отнаследовано от Control.

readRoles

Список ролей на чтение данных.

отнаследовано от Control.

writeRoles

Список ролей на изменение данных.

отнаследовано от Control.

visible

Видимость контрола.

Отнаследовано от Control.

width

Ширина контрола.

Отнаследовано от Control.

caption

тип	значение по умолчанию	допустимые значения
string	-

Заголовок контрола

bind

тип	значение по умолчанию	допустимые значения
string	-

Свойство, к которому биндится контрол.

value

тип	значение по умолчанию	допустимые значения
object	-

Значение контрола без биндинга

enabled

тип	значение по умолчанию	допустимые значения
bool	true	true/false

Доступность контрола для редактирования

События

valueChanged

Возникает при смене значения.

таблицаобъект

параметр	тип	описание
s	CheckBox	экземпляр класса контрола

s = CheckBox {
    ... // экземпляр класса CheckBox
}

Пример

myForm.xmlmyForm.js

<CheckBox ... valueChanged='CheckBoxExample_valueChanged' />

CheckBoxExample_valueChanged(s) {
    console.log(s)
}

Пример

Основным событием контролов, позволяющим обрабатывать взаимодействие пользователя с данными, является событие valueChanged. Его обработчики указываются в шаблоне стандартным способом.

Пример

myForm.xmlmyForm.js

<Group caption="CheckBox">
    <CheckBox caption="Пример галки" id="checkBox" captionWidth="1" editorWidth="1" valueChanged="checkBox_valueChanged"/>
    <CheckBox caption="Зависимая галка" id="slavedCheckBox" captionWidth="1" editorWidth="1" />
</Group>

checkBox_valueChanged () {
    this.controls.slavedCheckBox.value = this.controls.checkBox.value
}

Контрол CheckBox обладает простейшим функционалом. В примере продемонстрировано обращение и установка значения, которое хранит контрол (аналогичное свойство value имеется у большинства контролов).

---