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

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

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

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

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

<Top>0</Top>

Left

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

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

Если тэг <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>

Enabled

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

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

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

<Enabled>True</Enabled>

Visible

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

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

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

<Visible>True</Visible>

Opacity

Прозрачность объекта.

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

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

<Opacity>1</Opacity>

Hint

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

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

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

ContextMenu

Контекстное меню объекта.

Необязательный тэг. Значение тэга <ContextMenu>: не ожидается.

<ContextMenu Name="ContextMenuName" />

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

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

Change

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

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

Изменить значение прямым образом в графическом интерфейсе формы (атрибут User).
Указать источник значения - ссылка на любые данные на форме (атрибут Source).
В случае изменения значения в источнике, автоматически изменится значение и самого объекта.
Присвоить значение объекту посредством команды 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.

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

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>

Enabled

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

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

Visible

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

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

Opacity

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

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

Hint

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

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

Focused

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

<Object Name="ObjectName">
  <Property Name="Focused" />
</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>