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>
<ContextMenu>
Name
Название контекстного меню.
Обязательный атрибут. Ожидается название одного из контекстных меню, описанных в форме.
Change
Настройки изменения проперти ValueChanged
объекта.
Есть 3 способа изменить значение объекта:
Изменить значение прямым образом в графическом интерфейсе формы (атрибут
User
).Указать источник значения - ссылка на любые данные на форме (атрибут
Source
).В случае изменения значения в источнике, автоматически изменится значение и самого объекта.
Присвоить значение объекту посредством команды
ValueSetCommand
(атрибутValueSet
).
Необязательный тэг.
Если тэг <Change>
отсутствует, то для атрибутов User
, Source
и ValueSet
используются значения True, True, и True соответственно.
<Change User="True" Source="False" ValueSet="True" />
Атрибуты тэга <Change>
<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>
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>
Enabled
Задает признак активности объекта.
Ожидается логическое значение.
<Object Name="ObjectName">
<Property Name="Enabled">True</Property>
</Object>
Visible
Задает признак видимости объекта.
Ожидается логическое значение.
<Object Name="ObjectName">
<Property Name="Visible">True</Property>
</Object>
Opacity
Устанавливает значение прозрачности объекта
Ожидается численное значение от 0 до 1.
<Object Name="ObjectName">
<Property Name="Opacity">1</Property>
</Object>
Hint
Задает текст всплывающей подсказки объекта.
Любое значение будет переведено в текстовое.
<Object Name="ObjectName">
<Property Name="Hint">Подсказка</Property>
</Object>
BringToFront
Помещает объект на передний план.
Значение тэга <Property>
: не ожидается.
<Object Name="ObjectName">
<Property Name="BringToFront" />
</Object>
Last updated