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 способа изменить значение объекта:
Изменить значение прямым образом в графическом интерфейсе формы (атрибут
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.
Необязательный атрибут. Ожидается логическое значение.
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>
Last updated