Objects

Любой графический объект.

Описание Object

<MyObject Name="MyObjectName" Type="MyObjectType" Assembly="MyObjectAssembly" ChangeForm="True">
  <!--Тэги, общие для всех графических объектов-->
  <!--Тэги, специфичные для определенного графического объекта (зависит от типа)-->
</MyObject>

Атрибуты Object

Name	Название объекта. Обязательный атрибут.
Type	Название типа объекта в сборке. Обязательный атрибут.
Assembly	Название сборки (библиотека). Обязательный атрибут.
ChangeForm	Признак, определяющий, будет ли проперти ValueChanged данного объекта влиять на проперти FormChanged формы и ContainerChanged объектов-контейнеров типа GroupBox и Panel, на которых этот объект расположен. Необязательный атрибут. Если атрибут ChangeForm отсутствует, то используется значение True.

Получение значения Object

<Object Name="ObjectName" />

Любой графический объект имеет значение, которое, как правило, совпадает по смыслу с одним из его тэгов или проперти.

Задание значения Object

Значение объекта: любое значение.

<Object Name="ObjectName"></Object>

Тэги, общие для всех графических объектов

Top

Координата расположения объекта по высоте (сверху вниз).

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

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

Если тэг <Top> присутствует вместе с тэгом <Bottom>, то конфликт разрешается в пользу тэга <Bottom>.

<Top>0</Top>

Left

Координата расположения объекта по ширине (слева направо).

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

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

Если тэг <Left> присутствует вместе с тэгом <Right>, то конфликт разрешается в пользу тэга <Right>.

<Left>0</Left>

Height

Высота объекта.

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

Если тэг <Height> отсутствует, то используется значение по умолчанию для определенного объекта.

<Height>200</Height>

Width

Ширина объекта.

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

Если тэг <Width> отсутствует, то используется значение по умолчанию для определенного объекта.

<Width>100</Width>

Right

Координата правого края объекта.

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

Если тэг <Right> присутствует вместе с тэгом <Left>, то конфликт разрешается в пользу тэга <Right>.

<Right>100</Right>

Bottom

Координата нижнего края объекта.

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

Если тэг <Bottom> присутствует вместе с тэгом <Top>, то конфликт разрешается в пользу тэга <Bottom>.

<Bottom>200</Bottom>

FontStyle

Стиль шрифта объекта.

Необязательный тэг. Ожидается имя одного из стилей шрифтов, описанных в форме.

Если тэг <FontStyle> отсутствует, то используется значение FontStyle, которое указано для родительского объекта (если такового нет, то формы).

<FontStyle>FontStyle</FontStyle>

ForeColor

Цвет текста объекта.

Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb).

Если тэг <ForeColor> отсутствует, то используется значение ForeColor, которое указано для родительского объекта (если такового нет, то формы).

<ForeColor>ForeColor</ForeColor>

BackColor

Цвет фона объекта.

Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb).

Если тэг <BackColor> отсутствует, то используется значение BackColor, которое указано для родительского объекта (если такового нет, то формы).

<BackColor>BackColor</BackColor>

TabIndex

Индекс очереди при TAB-переходах.

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

Если тэг <TabIndex> отсутствует, то используется значение 0.

<TabIndex>0</TabIndex>

TabStop

Признак, определяющий, будет ли объект в очереди при TAB-переходах.

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

Если тэг <TabStop> отсутствует, то используется значение True.

<TabStop>True</TabStop>

Enabled

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

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

Если тэг <Enabled> отсутствует, то используется значение True.

<Enabled>True</Enabled>

Visible

Признак видимости объекта.

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

Если тэг <Visible> отсутствует, то используется значение True.

<Visible>True</Visible>

Hint

Текст всплывающей подсказки объекта.

Необязательный тэг. Любое значение будет переведено в текстовое.

<Hint>Подсказка</Hint>

Change

Настройки изменения проперти ValueChanged объекта.

Есть 3 способа изменить значение объекта:

1. Изменить значение прямым образом в графическом интерфейсе формы (атрибут User).

2. Указать источник значения - ссылка на любые данные на форме (атрибут Source).

   В случае изменения значения в источнике, автоматически изменится значение и самого объекта.

3. Присвоить значение объекту посредством команды ValueSetCommand (атрибут ValueSet).

Необязательный тэг.

Если тэг <Change> отсутствует, то для атрибутов User, Source и ValueSet используются значения True, True, и True соответственно.

<Change User="True" Source="False" ValueSet="True" />

Атрибуты тэга <Change>

User	Признак, определяющий, будет ли ValueChanged иметь значение True, если пользователь в графическом интерфейсе изменит значение объекта. Необязательный атрибут. Ожидается логическое значение.
Source	Признак, определяющий, будет ли ValueChanged иметь значение True, если значение объекта перезагрузится из источника. Если атрибут Source имеет значение False, и при этом значение из источника перезагрузилось, то ValueChanged будет иметь значение False. Необязательный атрибут. Ожидается логическое значение.
ValueSet	Признак, определяющий, будет ли ValueChanged иметь значение True, если значение объекта будет присвоено из команды ValueSetCommand. Если атрибут ValueSet имеет значение False, и при этом значение было присвоено из команды ValueSetCommand, то ValueChanged будет иметь значение False. Необязательный атрибут. Ожидается логическое значение.

Cursor

Курсор мыши, который появляется при наведении ее на объект.

Необязательный тэг. Ожидается название одного из типов курсора мыши:

Default	Значение по умолчанию (определено настройками операционной системы)
Arrow	Обычная стрелка
Wait	Индикатор ожидания
AppStarting	Изображение стрелки с индикатором ожидания
Hand	Изображение в виде руки
Beam	Изображение в виде буквы"I"
No	Изображение в виде перечеркнутого красного круга
Cross	Изображение в виде крестика
Help	Изображение стрелки и вопросительного знака
HSplit	Изображение, которое появляется при наведении указателя мыши на горизонтальный разделитель
SizeAll	Четырехконечный курсор для изменения размера, состоящий из четырех соединенных стрелок, указывающих вверх, вниз, налево и направо
SizeNESW	Двунаправленный (северо-восток — юго-запад) диагональный курсор для изменения размера
SizeNS	Двунаправленный вертикальный курсор для изменения размера
SizeNWSE	Двунаправленный (северо-запад — юго-восток) диагональный курсор для изменения размера
SizeWE	Двунаправленный горизонтальный курсор для изменения размера
VSplit	Курсор, который появляется при наведении указателя мыши на вертикальный разделитель
ZoomIn	Изображение в виде увеличительного стекла со знаком "+"
ZoomOut	Изображение в виде увеличительного стекла со знаком "-"
Grab	Изображение, указывающее на возможность схватить объект
Grabbing	Изображение, указывающее на то, что объект был схвачен

<Cursor>Default</Cursor>

CSS

Содержит фрагмент CSS-кода, описывающий настройки стиля объекта.

Необязательный тэг. Любое значение будет переведено в текстовое.

<CSS>background: rgba(210, 210, 210, 0.4);
box-shadow: 0px 0px 12px rgba(0, 0, 0, 0.16);</CSS>

Get-проперти для получения свойств

Перечисленные ниже get-проперти являются общими для всех графических объектов и предназначены для получения свойств данного объекта.

Value

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

<Object Name="ObjectName">
  <Property Name="Value" />
</Object>

ValueChanged

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

<Object Name="ObjectName">
  <Property Name="ValueChanged" />
</Object>

Top

Возвращает координату расположения объекта по высоте (сверху вниз).

<Object Name="ObjectName">
  <Property Name="Top" />
</Object>

Left

Возвращает координату расположения объекта по ширине (слева направо).

<Object Name="ObjectName">
  <Property Name="Left" />
</Object>

Height

Возвращает высоту объекта.

<Object Name="ObjectName">
  <Property Name="Height" />
</Object>

Width

Возвращает ширину объекта.

<Object Name="ObjectName">
  <Property Name="Width" />
</Object>

Right

Возвращает положение правого края объекта.

<Object Name="ObjectName">
  <Property Name="Right" />
</Object>

Bottom

Возвращает положение нижнего края объекта.

<Object Name="ObjectName">
  <Property Name="Bottom" />
</Object>

FontStyle

Возвращает имя стиля шрифта объекта.

<Object Name="ObjectName">
  <Property Name="FontStyle" />
</Object>

ForeColor

Возвращает имя цвета текста объекта.

<Object Name="ObjectName">
  <Property Name="ForeColor" />
</Object>

BackColor

Возвращает имя цвета фона объекта.

<Object Name="ObjectName">
  <Property Name="BackColor" />
</Object>

TabIndex

Возвращает индекс очереди при TAB-переходах.

<Object Name="ObjectName">
  <Property Name="TabIndex" />
</Object>

TabStop

Возвращает признак, определяющий, будет ли объект в очереди при TAB-переходах.

<Object Name="ObjectName">
  <Property Name="TabStop" />
</Object>

Enabled

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

<Object Name="ObjectName">
  <Property Name="Enabled" />
</Object>

Visible

Возвращает признак видимости объекта.

<Object Name="ObjectName">
  <Property Name="Visible" />
</Object>

Hint

Возвращает текст всплывающей подсказки объекта.

<Object Name="ObjectName">
  <Property Name="Hint" />
</Object>

Cursor

Возвращает название типа курсора мыши.

<Object Name="ObjectName">
  <Property Name="Cursor" />
</Object>

Focused

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

<Object Name="ObjectName">
  <Property Name="Focused" />
</Object>

CSS

Возвращает настройки стиля объекта, описываемые фрагментом CSS-кода.

<Object Name="ObjectName">
  <Property Name="CSS" />
</Object>

Set-проперти для динамического задания свойств

Перечисленные ниже set-проперти являются общими для всех графических объектов и предназначены для динамического задания свойств объекта (динамическое - означает, что в процессе работы формы, то есть посредством команды ValueSetCommand).

Value

Задает значение объекта.

Значение тэга <Property>: любое значение.

<Object Name="ObjectName">
  <Property Name="Value">Value</Property>
</Object>

ValueChanged

Задает признак изменения значения объекта.

Ожидается логическое значение.

<Object Name="ObjectName">
  <Property Name="ValueChanged">False</Property>
</Object>

Top

Задает координату расположения объекта по высоте (сверху вниз).

Ожидается целочисленное значение.

<Object Name="ObjectName">
  <Property Name="Top">10</Property>
</Object>

Left

Задает координату расположения объекта по ширине (слева направо).

Ожидается целочисленное значение.

<Object Name="ObjectName">
  <Property Name="Left">20</Property>
</Object>

Height

Задает высоту объекта.

Ожидается целочисленное значение.

<Object Name="ObjectName">
  <Property Name="Height">200</Property>
</Object>

Width

Задает ширину объекта.

Ожидается целочисленное значение.

<Object Name="ObjectName">
  <Property Name="Width">100</Property>
</Object>

Right

Задает положение правого края объекта.

Ожидается целочисленное значение.

<Object Name="ObjectName">
  <Property Name="Right">100</Property>
</Object>

Bottom

Задает положение нижнего края объекта.

Ожидается целочисленное значение.

<Object Name="ObjectName">
  <Property Name="Bottom">200</Property>
</Object>

FontStyle

Задает имя стиля шрифта объекта.

Ожидается название одного из стилей шрифтов, описанных в форме.

<Object Name="ObjectName">
  <Property Name="FontStyle">FontStyle</Property>
</Object>

ForeColor

Задает имя цвета текста объекта.

Ожидается название одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb).

<Object Name="ObjectName">
  <Property Name="ForeColor">ForeColor</Property>
</Object>

BackColor

Задает имя цвета фона объекта.

Ожидается название одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb).

<Object Name="ObjectName">
  <Property Name="BackColor">BackColor</Property>
</Object>

TabIndex

Задает индекс очереди при TAB-переходах.

Ожидается целочисленное значение.

<Object Name="ObjectName">
  <Property Name="TabIndex" />
</Object>

TabStop

Задает признак, определяющий, будет ли объект в очереди при TAB-переходах.

Ожидается логическое значение.

<Object Name="ObjectName">
  <Property Name="TabStop" />
</Object>

Enabled

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

Ожидается логическое значение.

<Object Name="ObjectName">
  <Property Name="Enabled">True</Property>
</Object>

Visible

Задает признак видимости объекта.

Ожидается логическое значение.

<Object Name="ObjectName">
  <Property Name="Visible">True</Property>
</Object>

Hint

Задает текст всплывающей подсказки объекта.

Любое значение будет переведено в текстовое.

<Object Name="ObjectName">
  <Property Name="Hint">Подсказка</Property>
</Object>

Cursor

Задает тип курсора мыши.

Ожидается название одного из типов курсора мыши.

<Object Name="ObjectName">
  <Property Name="Cursor">Hand</Property>
</Object>

CSS

Задает настройки стиля объекта, описываемые фрагментом CSS-кода.

Любое значение будет переведено в текстовое.

<Object Name="ObjectName">
  <Property Name="CSS">background: linear-gradient(to bottom right, rgba(36,81,128,1) 0%, rgba(36,126,111,1) 70%);</Property>
</Object>