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>

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>

StopOnError	Признак, определяющий, будет ли остановлено выполнение команд, если при выполнении очередной произойдет ошибка. Необязательный атрибут. Ожидается логическое значение. По умолчанию используется значение True.
Lock	Признак, определяющий, будет ли блокироваться форма при выполнении команд. Необязательный атрибут. Ожидается логическое значение. По умолчанию используется значение False.

Тэг <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 способа изменить значение объекта:

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

2. Указать источник значения (ссылка на любые данные на форме). В случае изменения значения в источнике, автоматически изменится значение и самого объекта.

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	Без пиктограммы.