# Objects ## Описание Object ```xml ``` #### Атрибуты Object
Name

Название объекта.

Обязательный атрибут.

Type

Название типа объекта в сборке.

Обязательный атрибут.

Assembly

Название сборки (библиотека).

Обязательный атрибут.

ChangeForm

Признак, определяющий, будет ли проперти ValueChanged данного объекта влиять на проперти FormChanged формы и ContainerChanged объектов-контейнеров типа GroupBox и Panel, на которых этот объект расположен.

Необязательный атрибут.

Если атрибут ChangeForm отсутствует, то используется значение True.

### Получение значения Object ```xml ``` Любой графический объект имеет значение, которое, как правило, совпадает по смыслу с одним из его тэгов или проперти. ### Задание значения Object Значение объекта: любое значение. ```xml ``` ## Тэги, общие для всех графических объектов ### Top Координата расположения объекта по высоте (сверху вниз). Необязательный тэг. Ожидается целочисленное значение. Если тэг `` отсутствует, то используется значение 0. Если тэг `` присутствует вместе с тэгом [``](#bottom), то конфликт разрешается в пользу тэга [``](#bottom). ```xml 0 ``` ### Left Координата расположения объекта по ширине (слева направо). Необязательный тэг. Ожидается целочисленное значение. Если тэг `` отсутствует, то используется значение 0. Если тэг `` присутствует вместе с тэгом [``](#right), то конфликт разрешается в пользу тэга [``](#right). ```xml 0 ``` ### Height Высота объекта. Необязательный тэг. Ожидается целочисленное значение. Если тэг `` отсутствует, то используется значение по умолчанию для определенного объекта. ```xml 200 ``` ### Width Ширина объекта. Необязательный тэг. Ожидается целочисленное значение. Если тэг `` отсутствует, то используется значение по умолчанию для определенного объекта. ```xml 100 ``` ### Right Координата правого края объекта. Необязательный тэг. Ожидается целочисленное значение. Если тэг `` присутствует вместе с тэгом [``](#left), то конфликт разрешается в пользу тэга ``. ```xml 100 ``` ### Bottom Координата нижнего края объекта. Необязательный тэг. Ожидается целочисленное значение. Если тэг `` присутствует вместе с тэгом [``](#top), то конфликт разрешается в пользу тэга ``. ```xml 200 ``` ### FontStyle Стиль шрифта объекта. Необязательный тэг. Ожидается имя одного из стилей шрифтов, описанных в форме. Если тэг `` отсутствует, то используется значение `FontStyle`, которое указано для родительского объекта (если такового нет, то формы). ```xml FontStyle ``` ### ForeColor Цвет текста объекта. Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). Если тэг `` отсутствует, то используется значение `ForeColor`, которое указано для родительского объекта (если такового нет, то формы). ```xml ForeColor ``` ### BackColor Цвет фона объекта. Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). Если тэг `` отсутствует, то используется значение `BackColor`, которое указано для родительского объекта (если такового нет, то формы). ```xml BackColor ``` ### TabIndex Индекс очереди при TAB-переходах. Необязательный тэг. Ожидается целочисленное значение. Если тэг `` отсутствует, то используется значение 0. ```xml 0 ``` ### TabStop Признак, определяющий, будет ли объект в очереди при TAB-переходах. Необязательный тэг. Ожидается логическое значение. Если тэг `` отсутствует, то используется значение True. ```xml True ``` ### Enabled Признак активности объекта. Необязательный тэг. Ожидается логическое значение. Если тэг `` отсутствует, то используется значение True. ```xml True ``` ### Visible Признак видимости объекта. Необязательный тэг. Ожидается логическое значение. Если тэг `` отсутствует, то используется значение True. ```xml True ``` ### Hint Текст всплывающей подсказки объекта. Необязательный тэг. Любое значение будет переведено в текстовое. ```xml Подсказка ``` ### HintBox Свойство, при наличии которого, радом с графическим элементом будет отображаться кнопка для вызова диалогового окна с текстом, указанным в тэге. Если значение тэга не указано или указана пустая строка, то кнопка отображаться не будет. При отображении кнопки диалогового окна, визуальная ширина графического элемента станет меньше, но get-проперти Width будет возвращать значение с учетом ширины кнопки. Необязательный тэг. Любое значение будет переведено в текстовое. Необязательный атрибут `Position` задает положение кнопки относительно графического элемента. Атрибут ожидает одно из допустимых значений:
LeftКнопка вызова диалогового окна слева от объекта
RightКнопка вызова диалогового окна справа от объекта
По умолчанию для атрибута `Position` используется значение Right. ```xml Подробная подсказка ``` ### ContextMenu Контекстное меню объекта. Необязательный тэг. Значение тэга ``: не ожидается. ```xml ``` ### Change Настройки изменения проперти [`ValueChanged`](#get_value_changed) объекта. Есть 3 способа изменить значение объекта: 1. Изменить значение прямым образом в графическом интерфейсе формы (атрибут `User`). 2. Указать источник значения - ссылка на любые данные на форме (атрибут `Source`). В случае изменения значения в источнике, автоматически изменится значение и самого объекта. 3. Присвоить значение объекту посредством команды [`ValueSetCommand`](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/commands/value_set_command) (атрибут `ValueSet`). Необязательный тэг. Если тэг `` отсутствует, то для атрибутов `User`, `Source` и `ValueSet` используются значения True, True, и True соответственно. ```xml ``` #### Атрибуты тэга ``
User

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

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

Source

Признак, определяющий, будет ли ValueChanged иметь значение True, если значение объекта перезагрузится из источника.

Если атрибут Source имеет значение False, и при этом значение из источника перезагрузилось, то ValueChanged будет иметь значение False.

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

ValueSet

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

Если атрибут ValueSet имеет значение False, и при этом значение было присвоено из команды ValueSetCommand, то ValueChanged будет иметь значение False.

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

### Anchor Определяет как будет изменяться размер объекта при изменении размера родительского объекта. Необязательный тэг. Если тэг отсутствует, то используются значения тэгов [\](#top) и [\](#left) самого объекта. ```xml True True False False ``` #### Тэг `` Объект привязан к верхней границе родительского объекта. Необязательный тэг. Ожидается логическое значение. #### Тэг `` Объект привязан к левой границе родительского объекта. Необязательный тэг. Ожидается логическое значение. #### Тэг `` Объект привязан к нижней границе родительского объекта. Необязательный тэг. Ожидается логическое значение. #### Тэг `` Объект привязан к правой границе родительского объекта. Необязательный тэг. Ожидается логическое значение. ### Cursor Курсор мыши, который появляется при наведении ее на объект. Необязательный тэг. Ожидается название одного из типов курсора мыши:
DefaultЗначение по умолчанию (определено настройками операционной системы)
ArrowОбычная стрелка
WaitИндикатор ожидания
AppStartingИзображение стрелки с индикатором ожидания
HandИзображение в виде руки
BeamИзображение в виде буквы"I"
NoИзображение в виде перечеркнутого красного круга
CrossИзображение в виде крестика
HelpИзображение стрелки и вопросительного знака
HSplitИзображение, которое появляется при наведении указателя мыши на горизонтальный разделитель
NoMove2DКурсор, который появляется при выполнении операций с помощью колесика мыши без движения самой мыши, но с возможностью прокручивать окно как в горизонтальном, так и в вертикальном направлениях
NoMoveHorizКурсор, который появляется при выполнении операций с помощью колесика мыши без движения самой мыши, но с возможностью прокручивать окно в горизонтальном направлении
NoMoveVertКурсор, который появляется при выполнении операций с помощью колесика мыши без движения самой мыши, но с возможностью прокручивать окно в вертикальном направлении
PanEastКурсор, который появляется при выполнении операций с помощью колесика мыши и движения самой мыши при горизонтальной прокрутке окна вправо
PanNEКурсор, который появляется при выполнении операций с помощью колесика мыши и движения самой мыши при прокрутке окна горизонтально и вертикально вверх и вправо
PanNorthКурсор, который появляется при выполнении операций с помощью колесика мыши и движения самой мыши при вертикальной прокрутке окна вверх
PanNWКурсор, который появляется при выполнении операций с помощью колесика мыши и движения самой мыши при прокрутке окна горизонтально и вертикально вверх и влево
PanSEКурсор, который появляется при выполнении операций с помощью колесика мыши и движения самой мыши при прокрутке окна горизонтально и вертикально вниз и вправо
PanSouthКурсор, который появляется при выполнении операций с помощью колесика мыши и движения самой мыши при вертикальной прокрутке окна вниз
PanSWКурсор, который появляется при выполнении операций с помощью колесика мыши и движения самой мыши при прокрутке окна горизонтально и вертикально вниз и влево
PanWestКурсор, который появляется при выполнении операций с помощью колесика мыши и движения самой мыши при горизонтальной прокрутке окна влево
SizeAllЧетырехконечный курсор для изменения размера, состоящий из четырех соединенных стрелок, указывающих вверх, вниз, налево и направо
SizeNESWДвунаправленный (северо-восток — юго-запад) диагональный курсор для изменения размера
SizeNSДвунаправленный вертикальный курсор для изменения размера
SizeNWSEДвунаправленный (северо-запад — юго-восток) диагональный курсор для изменения размера
SizeWEДвунаправленный горизонтальный курсор для изменения размера
UpArrowКурсор в виде стрелки вверх, обычно используемый для определения точки вставки
VSplitКурсор, который появляется при наведении указателя мыши на вертикальный разделитель
```xml Default ``` ## Get-проперти для получения свойств Перечисленные ниже get-проперти являются общими для всех графических объектов и предназначены для получения свойств данного объекта. ### Value Возвращает значение объекта, если его существование подразумевается для объекта определенного типа. ```xml ``` ### ValueChanged Возвращает признак изменения значения объекта, если существование значения подразумевается для объекта определенного типа. ```xml ``` ### Top Возвращает координату расположения объекта по высоте (сверху вниз). ```xml ``` ### Left Возвращает координату расположения объекта по ширине (слева направо). ```xml ``` ### Height Возвращает высоту объекта. ```xml ``` ### Width Возвращает ширину объекта. ```xml ``` ### Right Возвращает положение правого края объекта. ```xml ``` ### Bottom Возвращает положение нижнего края объекта. ```xml ``` ### FontStyle Возвращает имя стиля шрифта объекта. ```xml ``` ### ForeColor Возвращает имя цвета текста объекта. ```xml ``` ### BackColor Возвращает имя цвета фона объекта. ```xml ``` ### TabIndex Возвращает индекс очереди при TAB-переходах. ```xml ``` ### TabStop Возвращает признак, определяющий, будет ли объект в очереди при TAB-переходах. ```xml ``` ### Enabled Возвращает признак активности объекта. ```xml ``` ### Visible Возвращает признак видимости объекта. ```xml ``` ### Hint Возвращает текст всплывающей подсказки объекта. ```xml ``` ### Cursor Возвращает название типа курсора мыши. ```xml ``` ### Focused Возвращает признак, определяющий, имеет ли объект фокус. ```xml ``` ### AnchorTop Возвращает признак, определяющий, привязан ли объект к верхней границе родительского объекта. ```xml ``` ### AnchorLeft Возвращает признак, определяющий, привязан ли объект к левой границе родительского объекта. ```xml ``` ### AnchorBottom Возвращает признак, определяющий, привязан ли объект к нижней границе родительского объекта. ```xml ``` ### AnchorRight Возвращает признак, определяющий, привязан ли объект к правой границе родительского объекта. ```xml ``` ## Set-проперти для динамического задания свойств Перечисленные ниже set-проперти являются общими для всех графических объектов и предназначены для динамического задания свойств объекта (динамическое - означает, что в процессе работы формы, то есть посредством команды [`ValueSetCommand`](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/commands/value_set_command)). ### Value Задает значение объекта. Значение тэга ``: любое значение. ```xml Value ``` ### ValueChanged Задает признак изменения значения объекта. Ожидается логическое значение. ```xml False ``` ### Top Задает координату расположения объекта по высоте (сверху вниз). Ожидается целочисленное значение. ```xml 10 ``` ### Left Задает координату расположения объекта по ширине (слева направо). Ожидается целочисленное значение. ```xml 20 ``` ### Height Задает высоту объекта. Ожидается целочисленное значение. ```xml 200 ``` ### Width Задает ширину объекта. Ожидается целочисленное значение. ```xml 100 ``` ### Right Задает положение правого края объекта. Ожидается целочисленное значение. ```xml 100 ``` ### Bottom Задает положение нижнего края объекта. Ожидается целочисленное значение. ```xml 200 ``` ### FontStyle Задает имя стиля шрифта объекта. Ожидается название одного из стилей шрифтов, описанных в форме. ```xml FontStyle ``` ### ForeColor Задает имя цвета текста объекта. Ожидается название одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). ```xml ForeColor ``` ### BackColor Задает имя цвета фона объекта. Ожидается название одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb). ```xml BackColor ``` ### TabIndex Задает индекс очереди при TAB-переходах. Ожидается целочисленное значение. ```xml ``` ### TabStop Задает признак, определяющий, будет ли объект в очереди при TAB-переходах. Ожидается логическое значение. ```xml ``` ### Enabled Задает признак активности объекта. Ожидается логическое значение. ```xml True ``` ### Visible Задает признак видимости объекта. Ожидается логическое значение. ```xml True ``` ### Hint Задает текст всплывающей подсказки объекта. Любое значение будет переведено в текстовое. ```xml Подсказка ``` ### Cursor Задает тип курсора мыши. Ожидается название одного из типов курсора мыши. ```xml Hand ``` ### BringToFront Помещает объект на передний план. Значение тэга ``: не ожидается. ```xml ``` ### AnchorTop Задаёт привязку объекта к верхней границе родительского объекта. Ожидается логическое значение. ```xml True ``` ### AnchorLeft Задаёт привязку объекта к левой границе родительского объекта. Ожидается логическое значение. ```xml True ``` ### AnchorBottom Задаёт привязку объекта к нижней границе родительского объекта. Ожидается логическое значение. ```xml True ``` ### AnchorRight Задаёт привязку объекта к правой границе родительского объекта. Ожидается логическое значение. ```xml True ```