> For the complete documentation index, see [llms.txt](https://wfsys.gitbook.io/workflow-mobile-forms-syntax/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wfsys.gitbook.io/workflow-mobile-forms-syntax/workflow_mobile_forms/objects/button.md). # Button ## Шаблон Button Перечень всех возможных тэгов объекта: ```xml ``` ## Описание Button ```xml ``` Значением Button считается текст, указанный на кнопке. ### Получение значения Для получения указанного на кнопке текста используется get-проперти [Text](#text-1): ```xml ``` Рекомендуется использовать сокращенный вариант записи: ```xml ``` ### Задание значения Для задания отображаемого на кнопке текста используется set-проперти [Text](#set_text): ```xml Text ``` Рекомендуется использовать сокращенный вариант записи: ```xml Text ``` ## Тэги, специфичные для Button ### Blink Определяет мерцание надписи на кнопке. Необязательный тэг. Ожидается логическое значение. По умолчанию используется значение False. ```xml False ``` ### BlinkInterval Задает интервал мерцания надписи на кнопке (в миллисекундах). Необязательный тэг. Ожидается целочисленное значение. По умолчанию используется значение 500. ```xml 500 ``` ### FlatBorderSize Задает размер границы плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). Необязательный тэг. Ожидается целочисленное значение. По умолчанию используется значение 1. ```xml 1 ``` ### FlatBorderColor Задает цвет границы плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). По умолчанию используется стандартное значение .NET. ```xml FlatBorderColor ``` ### BorderCorner Закругление углов. Необязательный тэг. Ожидается целочисленное значение. Если тэг не задан, то используется значение 0. ```xml 0 ``` ### Image Путь до файла с графическим содержанием, которое будет расположено на кнопке. Необязательный тэг. Любое значение будет переведено в текстовое. ```xml Image ``` ### ImageAlign Определяет тип положения картинки. Необязательный тэг. Ожидается название одного из типов положения картинки:
TopLeftСлева сверху
TopCenterПо центру сверху
TopRightСправа сверху
MiddleLeftСлева посередине
MiddleCenterПо центру посередине
MiddleRightСправа посередине
BottomLeftСлева снизу
BottomCenterПо центру снизу
BottomRightСправа снизу
По умолчанию используется значение MiddleCenter**.** ```xml MiddleCenter ``` ### BackgroundImage Путь до файла с графическим содержанием, которое будет расположено на кнопке. Необязательный тэг. Любое значение будет переведено в текстовое. ```xml BackgroundImage ``` ### BackgroundImageLayout Определяет тип расположения графического содержания на кнопке. Необязательный тэг. Ожидается название одного из типов расположения графического содержания на кнопке:
CenterИзображение центрируется на кнопке
StretchИзображение растягивается на всю длину кнопки
ZoomИзображение увеличивается в пределах кнопки
По умолчанию используется значение Tile. ```xml Center ``` ### TextAlign Определяет тип положения текста. Необязательный тэг. Ожидается название одного из типов положения текста:
TopLeftСлева сверху
TopCenterПо центру сверху
TopRightСправа сверху
MiddleLeftСлева посередине
MiddleCenterПо центру посередине
MiddleRightСправа посередине
BottomLeftСлева снизу
BottomCenterПо центру снизу
BottomRightСправа снизу
По умолчанию используется значение MiddleLeft. ```xml MiddleLeft ``` ### Text Текст на кнопке. Необязательный тэг. Любое значение будет переведено в текстовое. ```xml Текст ``` ### DisabledMode Признак, при установке которого при нажатии на неактивную кнопку (Enabled = False) будет показано сообщение с текстом, указанным в тэге [``](#disabled_text). Необязательный тэг. Ожидается логическое значение. По умолчанию используется значение False. ```xml False ``` ### DisabledText Текст сообщения, которое будет показано по нажатию на неактивную кнопку с установленным признаком [``](#disabledmode). Необязательный тэг. Любое значение будет переведено в текстовое. ```xml Текст сообщения ``` ### Commands Список команд, которые будут выполнены при нажатии на кнопку. Необязательный тэг. В качестве значения тэга ожидается список тэгов [``](#teg-less-than-command-greater-than) и/или конструкций [``](/workflow-mobile-forms-syntax/workflow_mobile_forms/values/if.md). ```xml input 1 input 2 ``` #### Атрибуты тэга ``
StopOnError

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

Необязательный атрибут. Ожидается логическое значение.

По умолчанию используется значение True.

Lock

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

Необязательный атрибут. Ожидается логическое значение.

По умолчанию используется значение False.

#### Тэг `` Обращение к команде по имени для ее выполнения. Необязательный тэг. В качестве значения тэга ожидается список тэгов [``](/workflow-mobile-forms-syntax/workflow_mobile_forms/values/input.md). ```xml input 1 input 2 ``` ### ContentOrientation Настройка ориентации внутренних элементов кнопки (текст, изображение). Необязательный тэг. Для необязательного атрибута `Value` ожидается название одного из типов ориентации:
PortraitПортретная ориентация.
LandscapeRightОриентация поворота телефона вправо на 90 градусов.
LandscapeLeftОриентация поворота телефона влево на 90 градусов.
PortraitUpsideDownОриентация поворота телефона на 180 градусов.
По умолчанию для атрибута `Value` используется значение Portrait. ```xml ``` ## Get-проперти для получения свойств ### Blink Возвращает признак мерцания надписи на кнопке. ```xml ``` ### BlinkInterval Возвращает интервал мерцания надписи на кнопке (в миллисекундах). ```xml ``` ### FlatStyle Возвращает название типа границ кнопки. ```xml ``` ### FlatBorderSize Возвращает размер границы плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). ```xml ``` ### FlatBorderColor Возвращает имя цвета границы плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). ```xml ``` ### BorderCorner Возвращает значение закругления углов кнопки. ```xml ``` ### Image Возвращает путь до файла с графическим содержанием, которое будет расположено на кнопке. ```xml ``` ### ImageAlign Возвращает название типа положения картинки. ```xml ``` ### BackgroundImage Возвращает путь до файла с графическим содержанием, которое будет расположено на кнопке. ```xml ``` ### BackgroundImageLayout Возвращает название типа расположения графического содержания на кнопке. ```xml ``` ### TextAlign Возвращает название типа положения текста. ```xml ``` ### Text Возвращает текст на кнопке. ```xml ``` ## Set-проперти для динамического задания свойств ### Blink Задает признак мерцания надписи на кнопке. Ожидается логическое значение. ```xml True ``` ### BlinkInterval Задает интервал мерцания надписи на кнопке (в миллисекундах). Ожидается целочисленное значение. ```xml 1000 ``` ### FlatStyle Задает название типа границ кнопки. Ожидается одно из названий типов границ кнопки. ```xml Popup ``` ### FlatBorderSize Задает размер границы плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). Ожидается целочисленное значение. ```xml 1 ``` ### FlatBorderColor Задает имя цвета границы плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). Ожидается название одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). ```xml FlatBorderColor ``` ### BorderCorner Задает значение закругления углов кнопки. ```xml 0 ``` ### Image Задает путь до файла с графическим содержанием, которое будет расположено на кнопке. Любое значение будет переведено в текстовое. ```xml ``` ### ImageAlign Задает название типа положения картинки. Ожидается одно из названий типов положения картинки. ```xml TopLeft ``` ### BackgroundImage Задает путь до файла с графическим содержанием, которое будет расположено на кнопке. Любое значение будет переведено в текстовое. ```xml ``` ### BackgroundImageLayout Задает название типа расположения графического содержания на кнопке. Ожидается одно из названий типов расположения графического содержания на кнопке. ```xml ``` ### TextAlign Задает название типа положения текста. Ожидается одно из названий типов положения текста. ```xml TopLeft ``` ### Text Задает текст на кнопке. Любое значение будет переведено в текстовое. ```xml Text ```