MenuItem

Элемент меню, по нажатию на который выполняется определенная команда и/или раскрывается еще одно подменю.

Шаблон MenuItem

<MenuItem Name="" Type="MenuItem">
  <!--Тэги, общие для всех элементов меню-->
  <Enabled></Enabled>
  <Visible></Visible>
  <!--Тэги, специфичные для типа MenuItem-->
  <Title></Title>
  <Image></Image>
  <Command Name="" />
  <Commands StopOnError="" Lock="">
    <Command Name="" />
    <If>
      <When></When>
      <Then StopOnError="" Lock="">
        <Command Name="" />
      </Then>
      <ElseIf>
        <When></When>
        <Then StopOnError="" Lock="">
          <Command Name="">
            <Input Name="" />
            <Input Name="" />
          </Command>
        </Then>
      </ElseIf>
      <Else StopOnError="" Lock="">
        <Command Name="" />
      </Else>
    </If>
  </Commands>
  <ForeColor></ForeColor>
  <Blink></Blink>
  <BlinkInterval></BlinkInterval>
  <BlinkPart></BlinkPart>
  <Items></Items>
  <Hint></Hint>
  <IsInstruction></IsInstruction>
</MenuItem>

Описание MenuItem

<MenuItem Name="MenuItemName" Type="MenuItem">
  <!--Тэги, общие для всех элементов меню-->
  <!--Тэги, специфичные для MenuItem-->
</MenuItem>

Тэги, специфичные для MenuItem

Title

Текст элемента меню.

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

<Title>Текст</Title>

Image

Путь до файла с графическим содержанием, которое будет расположено на элементе меню.

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

<Image>Image</Image>

Command

Задает имя команды, которая будет выполнена при нажатии на элемент меню. Игнорируется, если указан тэг <Commands>.

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

Допускается передача в команду значения через тэг <Input>.

<!--Вариант 1-->
<Command Name="CommandName1" />

<!--Вариант 2-->
<Command Name="CommandName2">
  <Input Name="InputName1">input 1</Input>
  <Input Name="InputName2">input 2</Input>
</Command>

Commands

Последовательность команд, которые будут выполнены при нажатии на элемент меню. Имеет приоритет над тэгом <Command>.

Необязательный тэг. В качестве значения тэга ожидается список тэгов <Command>, для вызова команды по имени, и/или конструкций <If>, задающих условия вызова команд.

<Commands StopOnError="" Lock="">
  <Command Name="" />
  <If>
    <When></When>
    <Then StopOnError="" Lock="">
      <Command Name="" />
    </Then>
    <ElseIf>
      <When></When>
      <Then StopOnError="" Lock="">
        <Command Name="">
          <Input Name="" />
          <Input Name="" />
        </Command>
      </Then>
    </ElseIf>
    <Else StopOnError="" Lock="">
      <Command Name="" />
    </Else>
  </If>
</Commands>

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

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

ForeColor

Цвет текста пункта меню.

Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb).

По умолчанию используется цвет, указанный в теге ForeColor для MainMenu.

<ForeColor>ForeColor</ForeColor>

Blink

Признак, включающий режим мигания.

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

По умолчанию используется значение False.

<Blink>True</Blink>

BlinkInterval

Задает интервал мигания (в миллисекундах).

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

По умолчанию используется значение 500.

<BlinkInterval>500</BlinkInterval>

BlinkPart

Признак, определяющий режим мигания: только текст, только изображение или текст и изображение одновременно.

Необязательный тэг. Ожидается название одного из режимов:

All	Мигают и текст и изображение
Text	Мигает только текст
Image	Мигает только изображение

По умолчанию используется значение All.

<BlinkPart>Image</BlinkPart>

Items

Вложенные элементы меню: пункты MenuItem и/или разделители Separator.

Необязательный тэг. Значение тэга список тэгов <MenuItem>.

<Items>
  <MenuItem Name="" Type="MenuItem">
    <Title></Title>
    <Command Name="" />
  </MenuItem>
  <MenuItem Name="" Type="Separator" />
  <MenuItem Name="" Type="MenuItem">
    <Title></Title>
    <Commands>
      <Command Name="" />
    </Commands>
  </MenuItem>
</Items>

Hint

Текст всплывающей подсказки элемента меню.

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

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

IsInstruction

Признак помечающий пункты меню, которые должны отображаться в крайнем правом положении в панели меню. Используется только для MainMenu и пунктов меню верхнего уровня. Для вложенных пунктов меню игнорируется.

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

По умолчанию используется значение False.

<IsInstruction>True</IsInstruction>

Get-проперти для получения свойств

Title

Возвращает текст элемента меню.

<Object Name="MenuItemName">
  <Property Name="Title" />
</Object>

Image

Возвращает путь до файла с графическим содержанием, которое расположено на элементе меню.

<Object Name="MenuItemName">
  <Property Name="Image" />
</Object>

Hint

Возвращает текст всплывающей подсказки элемента меню.

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

Set-проперти для динамического задания свойств

Title

Задает текст элемента меню.

Любое значение будет переведено в текстовое.

<Object Name="MenuItemName">
  <Property Name="Title">Текст</Property>
</Object>

Image

Задает путь до файла с графическим содержанием, которое будет расположено на элементе меню.

Любое значение будет переведено в текстовое.

<Object Name="MenuItemName">
  <Property Name="Image" />
</Object>

Hint

Задает текст всплывающей подсказки элемента меню.

Любое значение будет переведено в текстовое.

<Object Name="MenuItemName">
  <Property Name="Hint">Подсказка</Property>
</Object>