TrayIcon
Иконка в трее.
Шаблон TrayIcon
Перечень всех возможных тэгов объекта:
<MyObject Name="" Type="TrayIcon" Assembly="BaseControls" ChangeForm="">
<Icon></Icon>
<Text></Text>
<HideFormOnMinimize></HideFormOnMinimize>
<Blink></Blink>
<BlinkInterval></BlinkInterval>
<Visible></Visible>
<ContextMenu Name="" />
<Commands StopOnError="" Lock="">
<Command Name="" />
<If>
<When></When>
<Then StopOnError="" Lock="">
<Command Name="" />
</Then>
<ElseIf>
<When></When>
<Then StopOnError="" Lock="">
<Command Name="" />
</Then>
</ElseIf>
<Else StopOnError="" Lock="">
<Command Name="" />
</Else>
</If>
</Commands>
</MyObject>
Описание TrayIcon
<MyObject Name="" Type="TrayIcon" Assembly="BaseControls" ChangeForm="True">
<!--Тэги, специфичные для TrayIcon-->
</MyObject>
Атрибуты TrayIcon
Name
Название переменной.
Обязательный атрибут.
Type
Название типа переменной в сборке.
Обязательный атрибут.
Assembly
Название сборки (библиотека).
Обязательный атрибут.
Получение значения
Значением TrayIcon считается текст иконки.
<Object Name="TrayIconName" />
Задание значения
Значение объекта: любое значение.
<Object Name="TrayIconName"></Object>
Тэги, специфичные для TrayIcon
Change
Настройки изменения проперти ValueChanged
объекта.
Необязательный тэг.
Если тэг <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.
Обязательный атрибут. Ожидается логическое значение.
Icon
Путь до файла типа ICO с графическим содержанием, которое будет расположено на иконке в трее.
Необязательный тэг. Любое значение будет переведено в текстовое.
Если тэг <Icon>
отсутствует, то в качестве изображения будет использована иконка по умолчанию.
<Icon>Icon.ico</Icon>
Text
Текст иконки (текст, всплывающий при наведении курсора мышки).
Необязательный тэг. Любое значение будет переведено в текстовое.
<Text>Текст</Text>
HideFormOnMinimize
Признак, определяющий, будет ли исчезать окно при сворачивании.
Необязательный тэг. Ожидается логическое значение.
По умолчанию используется значение True.
<HideFormOnMinimize>True</HideFormOnMinimize>
Blink
Признак моргания иконки в трее.
Необязательный тэг. Ожидается логическое значение.
По умолчанию используется значение False.
<Blink>False</Blink>
BlinkInterval
Интервал моргания иконки в трее (в миллисекундах).
Необязательный тэг. Ожидается целочисленное значение.
По умолчанию используется значение 500.
<BlinkInterval>500</BlinkInterval>
Visible
Признак видимости иконки в трее.
Необязательный тэг. Ожидается логическое значение.
По умолчанию используется значение True.
<Visible>False</Visible>
ContextMenu
Контекстное меню иконки в трее.
Необязательный тэг. Значение тэга <ContextMenu>
: не ожидается.
<ContextMenu Name="ContextMenuName" />
Атрибуты тэга <ContextMenu>
<ContextMenu>
Name
Название контекстного меню.
Обязательный атрибут. Ожидается название одного из контекстных меню, описанных в форме.
Commands
Список команд, которые будут выполнены при нажатии на иконку в трее.
Необязательный тэг. В качестве значения тэга ожидается список тэгов <Command>
и/или конструкций <If>
.
<Commands StopOnError="True" Lock="">
<Command Name="CommandName1" />
<If>
<When></When>
<Then StopOnError="True" Lock="">
<Command Name="CommandName2">
<Input Name="InputName1">input 1</Input>
<Input Name="InputName2">input 2</Input>
</Command>
</Then>
<ElseIf>
<When></When>
<Then StopOnError="True" Lock="">
<Command Name="CommandName3" />
</Then>
</ElseIf>
<Else StopOnError="True" Lock="">
<Command Name="CommandName4" />
</Else>
</If>
</Commands>
Атрибуты тэга <Commands>
<Commands>
StopOnError
Признак, определяющий, будет ли остановлено выполнение команд, если при выполнении очередной произойдет ошибка.
Необязательный атрибут. Ожидается логическое значение.
По умолчанию используется значение True.
Lock
Признак, определяющий, будет ли блокироваться форма при выполнении команд.
Необязательный атрибут. Ожидается логическое значение.
По умолчанию используется значение False.
Тэг <Command>
<Command>
Обращение к команде по имени для ее выполнения.
Необязательный тэг. В качестве значения тэга ожидается список тэгов <Input>
.
<!--Вариант 1-->
<Command Name="CommandName1" />
<!--Вариант 2-->
<Command Name="CommandName2">
<Input Name="InputName1">input 1</Input>
<Input Name="InputName2">input 2</Input>
</Command>
Get-проперти для получения свойств
Value
Возвращает текст иконки (текст, всплывающий при наведении курсора мышки).
<Object Name="TrayIconName">
<Property Name="Value" />
</Object>
ValueChanged
Возвращает признак того, было ли изменено значение объекта TrayIcon в процессе работы.
Есть 3 способа изменить значение объекта:
Изменить значение прямым образом в графическом интерфейсе формы.
Указать источник значения (ссылка на любые данные на форме). В случае изменения значения в источнике, автоматически изменится значение и самого объекта.
Присвоить значение объекту посредством команды ValueSetCommand.
<Object Name="TrayIconName">
<Property Name="ValueChanged" />
</Object>
Icon
Возвращает путь до файла типа ICO с графическим содержанием, которое расположено на иконке в трее.
<Object Name="TrayIconName">
<Property Name="Icon" />
</Object>
Text
Возвращает текст иконки (текст, всплывающий при наведении курсора мышки).
<Object Name="TrayIconName">
<Property Name="Text" />
</Object>
HideFormOnMinimize
Возвращает признак, определяющий, будет ли исчезать окно при сворачивании.
<Object Name="TrayIconName">
<Property Name="HideFormOnMinimize" />
</Object>
Blink
Возвращает признак моргания иконки в трее.
<Object Name="TrayIconName">
<Property Name="Blink" />
</Object>
BlinkInterval
Возвращает интервал моргания иконки в трее (в миллисекундах).
<Object Name="TrayIconName">
<Property Name="BlinkInterval" />
</Object>
Visible
Возвращает признак видимости объекта.
<Object Name="ObjectName">
<Property Name="Visible" />
</Object>
Set-проперти для динамического задания свойств
Value
Задает текст иконки (текст, всплывающий при наведении курсора мышки).
Любое значение будет переведено в текстовое.
<Object Name="TrayIconName">
<Property Name="Value">Text</Property>
</Object>
ValueChanged
Задает признак изменения значения текста иконки.
Ожидается логическое значение.
<Object Name="TrayIconName">
<Property Name="ValueChanged">False</Property>
</Object>
Icon
Задает путь до файла типа ICO с графическим содержанием, которое будет расположено на иконке в трее.
Любое значение будет переведено в текстовое.
<Object Name="TrayIconName">
<Property Name="Icon" />
</Object>
Text
Задает текст иконки (текст, всплывающий при наведении курсора мышки).
Любое значение будет переведено в текстовое.
<Object Name="TrayIconName">
<Property Name="Text">Text</Property>
</Object>
HideFormOnMinimize
Задает признак, определяющий, будет ли исчезать окно при сворачивании.
Ожидается логическое значение.
<Object Name="TrayIconName">
<Property Name="HideFormOnMinimize">True</Property>
</Object>
Blink
Задает признак моргания иконки в трее.
Ожидается логическое значение.
<Object Name="TrayIconName">
<Property Name="Blink">True</Property>
</Object>
BlinkInterval
Задает интервал моргания иконки в трее (в миллисекундах).
Ожидается целочисленное значение.
<Object Name="TrayIconName">
<Property Name="BlinkInterval">1000</Property>
</Object>
Visible
Задает признак видимости объекта.
Ожидается логическое значение.
<Object Name="ObjectName">
<Property Name="Visible">True</Property>
</Object>
Show
Делает иконку в трее видимой.
Значение тэга Property: не ожидается.
<Object Name="TrayIconName">
<Property Name="Show" />
</Object>
Hide
Делает иконку в трее невидимой.
Значение тэга Property: не ожидается.
<Object Name="TrayIconName">
<Property Name="Hide" />
</Object>
ShowTip
Показывает всплывающую подсказку с текстом Text заголовком Title и пиктограммой типа Type над иконкой в трее.
<Object Name="TrayIconName">
<!--Значение тэга Property: тэг Parameters со вложенными тэгами Parameter-->
<Property Name="ShowTip">
<Parameters>
<!--Значение тэга Parameter с атрибутом Name, равным Text: любое значение будет переведено в текстовое-->
<Parameter Name="Text">Text</Parameter>
<!--Значение тэга Parameter с атрибутом Name, равным Title: любое значение будет переведено в текстовое-->
<Parameter Name="Title">Title</Parameter>
<!--Необязательный параметр. При отсутствии используется значение None-->
<!--Значение тэга Parameter с атрибутом Name, равным Type: ожидается название одного из типов пиктограмм для всплывающей подсказки-->
<Parameter Name="Type">Info</Parameter>
</Parameters>
</Property>
</Object>
Типы пиктограмм для всплывающей подсказки для иконки в трее:
Information
Пиктограмма содержит символ, состоящий из буквы i в нижнем регистре, помещенной в синий кружок.
Warning
Пиктограмма содержит символ, состоящий из восклицательного знака в желтом треугольнике.
Error
Пиктограмма содержит символ, состоящий из белого значка Х, заключенного в красный кружок.
None
Без пиктограммы.
Last updated