Button

Элемент управления, предназначенный для выполнения каких-либо дейставий при клике на нем.

Свойства

id

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

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

hint

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

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

tags

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

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

captionWidth

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

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

editorWidth

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

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

captionTextAlign

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

Выравнивание текста заголовка контрола.

denyRoles

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

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

readRoles

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

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

writeRoles

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

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

value

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

Текст на кнопке

visible

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

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

enabled

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

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

width

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

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

noBlock

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

Позволяет выключить блокировку контрола (значение true), если форма была заблокирована пользователем через пессимистический блокировщик.

Методы

focus

Устанавливает фокус на контрол.

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

События

clicked

Возникает при клике по кнопке.

clicked(s)

Пример

myForm.xmlmyForm.js

    <Button id="ButtonDisabled" value="Выключить кнопку на 2 сек" 
        editorWidth="1" captionWidth="0" clicked="ButtonDisabled_clicked" />

ButtonDisabled_clicked() {
    this.services.dialog.info('Нажатие зарегистрировано!');
    this.controls.simpleButton.enabled = false;<br/>
    setTimeout(() => {
        this.controls.simpleButton.enabled = true;
    }, 2000);
}

Пример

В методе-обработчике нажатия на кнопки продемонстрирована работа со свойством активности кнопки и изменение их надписей.

myForm.xmlmyForm.js

<Group caption="Button" editorWidth="3">
        <Button value="Нажать cюда" id="simpleButton" editorWidth="1" captionWidth="0" clicked="simpleButton_clicked"/>
        <Button id="simpleButton2" enabled="false" editorWidth="1" captionWidth="0" clicked="simpleButton_clicked"/>
</Group>

simpleButton_clicked () {
    const { simpleButton, simpleButton2 } = this.controls;

    this.services.dialog.info('Нажатие зарегистрировано!')

    simpleButton.enabled = simpleButton2.enabled
    simpleButton2.enabled = !simpleButton.enabled

    simpleButton.value = simpleButton.enabled ? 'Теперь сюда' : ''
    simpleButton2.value = simpleButton2.enabled ? 'Теперь сюда' : ''
}

---