# Button ## Шаблон Button Перечень всех возможных тэгов объекта: ```xml ``` ## Описание Button ```xml ``` Значением Button считается текст, указанный на кнопке. ### Получение значения Для получения указанного на кнопке текста используется get-проперти [Text](#text-1): ```xml ``` Рекомендуется использовать сокращенный вариант записи: ```xml ``` ### Задание значения Для задания отображаемого на кнопке текста используется set-проперти [Text](#set_text): ```xml Text ``` Рекомендуется использовать сокращенный вариант записи: ```xml Text ``` ## Тэги, специфичные для Button ### Blink Признак, включающий режим мигания. Необязательный тэг. Ожидается логическое значение. По умолчанию используется значение False. ```xml True ``` ### BlinkInterval Задает интервал мигания (в миллисекундах). Необязательный тэг. Ожидается целочисленное значение. По умолчанию используется значение 500. ```xml 500 ``` ### BlinkPart Признак, определяющий режим мигания: только текст, только изображение или текст и изображение одновременно. Необязательный тэг. Ожидается название одного из режимов:
AllМигают и текст и изображение
TextМигает только текст
ImageМигает только изображение
По умолчанию используется значение All. ```xml Image ``` ### FlatStyle Задает тип границ кнопки. Необязательный тэг. Ожидается название одного из стилей отображения кнопки:
FlatПлоская
PopupПлоская, пока не наведена мышь
StandardОбычная
SystemОпределяется операционной системой
По умолчанию используется значение Standard. ```xml Standard ``` ### FlatBorderSize Задает размер границы плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). Необязательный тэг. Ожидается целочисленное значение. По умолчанию используется значение 1. ```xml 1 ``` ### FlatBorderColor Задает цвет границы плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). По умолчанию используется стандартное значение .NET. ```xml FlatBorderColor ``` ### FlatMouseDownBackColor Задает цвет нажатой плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). Если тэг `` отсутствует, то цвет рассчитывается автоматически. ```xml FlatMouseDownBackColor ``` ### FlatMouseOverBackColor Задает цвет плоской кнопки при наведении курсора мыши (кнопки, свойство [``](#flat_style) которой равно Flat). Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). Если тэг `` отсутствует, то цвет рассчитывается автоматически. ```xml FlatMouseOverBackColor ``` ### Image Путь до файла с графическим содержанием, которое будет расположено на кнопке. Необязательный тэг. Любое значение будет переведено в текстовое. ```xml Image ``` ### ImageAlign Определяет тип положения картинки. Необязательный тэг. Ожидается название одного из типов положения картинки:
TopLeftСлева сверху
TopCenterПо центру сверху
TopRightСправа сверху
MiddleLeftСлева посередине
MiddleCenterПо центру посередине
MiddleRightСправа посередине
BottomLeftСлева снизу
BottomCenterПо центру снизу
BottomRightСправа снизу
По умолчанию используется значение MiddleCenter**.** ```xml MiddleCenter ``` ### BackgroundImage Путь до файла с графическим содержанием, которое будет расположено на кнопке. Необязательный тэг. Любое значение будет переведено в текстовое. ```xml BackgroundImage ``` ### BackgroundImageLayout Определяет тип расположения графического содержания на кнопке. Необязательный тэг. Ожидается название одного из типов расположения графического содержания на кнопке:
NoneИзображение выравнивается на кнопке вверху по левой стороне
TileВыполняется мозаичное заполнение изображением кнопки
CenterИзображение центрируется на кнопке
StretchИзображение растягивается на всю длину кнопки
ZoomИзображение увеличивается в пределах кнопки
По умолчанию используется значение Tile. ```xml Tile ``` ### 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) и/или конструкций [``](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/values/if). ```xml input 1 input 2 ``` #### Атрибуты тэга ``
StopOnError

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

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

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

Lock

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

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

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

#### Тэг `` Обращение к команде по имени для ее выполнения. Необязательный тэг. В качестве значения тэга ожидается список тэгов [``](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/values/input). ```xml input 1 input 2 ``` ## Get-проперти для получения свойств ### Blink Возвращает значение признака мигания. ```xml ``` ### BlinkInterval Возвращает интервал мигания (в миллисекундах). ```xml ``` ### BlinkPart Возвращает название режима мигания. ```xml ``` ### FlatStyle Возвращает название типа границ кнопки. ```xml ``` ### FlatBorderSize Возвращает размер границы плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). ```xml ``` ### FlatBorderColor Возвращает имя цвета границы плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). ```xml ``` ### FlatMouseDownBackColor Возвращает имя цвета нажатой плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). ```xml ``` ### FlatMouseOverBackColor Возвращает имя цвета плоской кнопки при наведении курсора мыши (кнопки, свойство [``](#flat_style) которой равно Flat). ```xml ``` ### Image Возвращает путь до файла с графическим содержанием, которое будет расположено на кнопке. ```xml ``` ### ImageAlign Возвращает название типа положения картинки. ```xml ``` ### BackgroundImage Возвращает путь до файла с графическим содержанием, которое будет расположено на кнопке. ```xml ``` ### BackgroundImageLayout Возвращает название типа расположения графического содержания на кнопке. ```xml ``` ### TextAlign Возвращает название типа положения текста. ```xml ``` ### Text Возвращает текст на кнопке. ```xml ``` ### DisabledMode Возвращает значение признака [``](#disabled_mode). ```xml ``` ### DisabledText Возвращает текст сообщения, заданное для признака [``](#disabled_text). ```xml ``` ## Set-проперти для динамического задания свойств ### Blink Задает признак мигания. Ожидается логическое значение. ```xml True ``` ### BlinkInterval Задает интервал мигания (в миллисекундах). Ожидается целочисленное значение. ```xml 1000 ``` ### BlinkPart Задает название режима мигания. Ожидается одно из названий режимов мигания. ```xml Text ``` ### FlatStyle Задает название типа границ кнопки. Ожидается одно из названий типов границ кнопки. ```xml Popup ``` ### FlatBorderSize Задает размер границы плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). Ожидается целочисленное значение. ```xml 1 ``` ### FlatBorderColor Задает имя цвета границы плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). Ожидается название одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). ```xml FlatBorderColor ``` ### FlatMouseDownBackColor Задает имя цвета нажатой плоской кнопки (кнопки, свойство [``](#flat_style) которой равно Flat). Ожидается название одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). ```xml FlatMouseDownBackColor ``` ### FlatMouseOverBackColor Задает имя цвета плоской кнопки при наведении курсора мыши (кнопки, свойство [``](#flat_style) которой равно Flat). Ожидается название одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). ```xml FlatMouseOverBackColor ``` ### Image Задает путь до файла с графическим содержанием, которое будет расположено на кнопке. Любое значение будет переведено в текстовое. ```xml ``` ### ImageAlign Задает название типа положения картинки. Ожидается одно из названий типов положения картинки. ```xml TopLeft ``` ### BackgroundImage Задает путь до файла с графическим содержанием, которое будет расположено на кнопке. Любое значение будет переведено в текстовое. ```xml ``` ### BackgroundImageLayout Задает название типа расположения графического содержания на кнопке. Ожидается одно из названий типов расположения графического содержания на кнопке. ```xml ``` ### TextAlign Задает название типа положения текста. Ожидается одно из названий типов положения текста. ```xml TopLeft ``` ### Text Задает текст на кнопке. Любое значение будет переведено в текстовое. ```xml Text ``` ### DisabledMode Задает значение признака [``](#disabled_mode). ```xml ``` ### DisabledText Задает текст сообщения для признака [``](#disabled_text). ```xml ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/objects/button.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.