Элемент управления типа Меню

Меню определяет список параметров. Каждый элемент меню либо выполняет функцию, либо отображает область задач.

Примечание.

Эта статья предполагает знакомство с основной справочной статьей по Control , которая содержит важную информацию об атрибутах элемента.

Элемент управления меню определяет:

  • Элемент управления меню корневого уровня.
  • Список элементов меню.

При использовании с точкой расширения PrimaryCommandSurface корневой элемент меню отображается в виде кнопки на ленте. Если кнопка нажата, меню отображается в виде раскрывающегося списка. Подменю не поддерживаются.

При использовании с точкой расширения ContextMenu в контекстном меню отображается элемент корневого меню. При выборе корневого элемента элементы меню отображаются в виде подменю. Ни один из элементов не может быть подменю, так как поддерживается только один уровень подменю.

Дочерние элементы

Элемент Обязательный Описание
Label Да Текст меню.
Supertip Да Суперсовет для этого меню.

Важно! Суперсоветы поддерживаются только в классических клиентах Office.
Icon Да Изображение для меню.
<Элементы> Да Коллекция элементов для отображения в меню. Содержит <элемент Item> для каждого элемента.
OverriddenByRibbonApi Нет Указывает, должно ли меню отображаться в сочетаниях приложений и платформ, поддерживающих настраиваемые контекстные вкладки. Если используется, это должен быть первый дочерний элемент.

Label

Задает текст для имени меню с помощью его единственного атрибута resid, который может состоять не более чем из 32 символов и должен быть установлен в значение атрибута <id элемента String> в <дочернем элементе ShortStrings> элемента Resources.

Тип надстройки: Область задач, почта

Допустимо только в следующих схемах VersionOverrides:

  • Область задач 1.0
  • Почта 1.0
  • Почта 1.1

Дополнительные сведения см. в статье "Переопределения версий в манифесте только для надстроек".

Связанные с этими наборами требований:

  • AddinCommands 1.1 , если родительским <параметром VersionOverrides> является тип области задач 1.0.
  • Почтовый ящик 1.3 , если родительское <значение VersionOverrides> имеет тип Mail 1.0.
  • Почтовый ящик 1.5 , если родительское <значение VersionOverrides> имеет тип Mail 1.1.

Примеры

В следующем примере в меню есть два пункта. На первом отображается область задач. Второй выполняет функцию. Меню настроено таким образом, чтобы его нельзя было увидеть, если надстройка работает на платформе, поддерживающей контекстные вкладки. Дополнительные сведения см. в статье "Реализация альтернативного взаимодействия с пользовательским интерфейсом, когда пользовательские контекстные вкладки не поддерживаются".

<Control xsi:type="Menu" id="Contoso.TestMenu2">
  <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
  <Label resid="residLabel3" />
  <Supertip>
    <Title resid="residLabel" />
    <Description resid="residToolTip" />
  </Supertip>
  <Icon>
    <bt:Image size="16" resid="icon1_32x32" />
    <bt:Image size="32" resid="icon1_32x32" />
    <bt:Image size="80" resid="icon1_32x32" />
  </Icon>
  <Items>
    <Item id="ShowMainTaskPane">
      <Label resid="residLabel3"/>
      <Supertip>
        <Title resid="residLabel" />
        <Description resid="residToolTip" />
      </Supertip>
      <Icon>
        <bt:Image size="16" resid="icon1_32x32" />
        <bt:Image size="32" resid="icon1_32x32" />
        <bt:Image size="80" resid="icon1_32x32" />
      </Icon>
      <Action xsi:type="ShowTaskpane">
        <TaskpaneId>MyTaskPaneID1</TaskpaneId>
        <SourceLocation resid="residUnitConverterUrl" />
      </Action>
    </Item>
    <Item id="GetData">
      <Label resid="residLabel5"/>
      <Supertip>
        <Title resid="residLabel" />
        <Description resid="residToolTip" />
      </Supertip>
      <Icon>
        <bt:Image size="16" resid="icon4_32x32" />
        <bt:Image size="32" resid="icon4_32x32" />
        <bt:Image size="80" resid="icon4_32x32" />
      </Icon>
      <Action xsi:type="ExecuteFunction">
        <FunctionName>getData</FunctionName>
      </Action>
    </Item>
  </Items>
</Control>

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

<Control xsi:type="Menu" id="Contoso.msgReadMenuButton">
  <Label resid="menuReadButtonLabel" />
  <Supertip>
    <Title resid="menuReadSuperTipTitle" />
    <Description resid="menuReadSuperTipDescription" />
  </Supertip>
  <Icon>
    <bt:Image size="16" resid="red-icon-16" />
    <bt:Image size="32" resid="red-icon-32" />
    <bt:Image size="80" resid="red-icon-80" />
  </Icon>
  <Items>
    <Item id="ShowMainTaskPane">
      <Label resid="residLabel3"/>
      <Supertip>
        <Title resid="residLabel" />
        <Description resid="residToolTip" />
      </Supertip>
      <Icon>
        <bt:Image size="16" resid="icon1_32x32" />
        <bt:Image size="32" resid="icon1_32x32" />
        <bt:Image size="80" resid="icon1_32x32" />
      </Icon>
      <Action xsi:type="ShowTaskpane">
        <TaskpaneId>MyTaskPaneID1</TaskpaneId>
        <SourceLocation resid="residUnitConverterUrl" />
      </Action>
    </Item>
    <Item id="msgReadMenuItem1">
      <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
      <Label resid="menuItem1ReadLabel" />
      <Supertip>
        <Title resid="menuItem1ReadLabel" />
        <Description resid="menuItem1ReadTip" />
      </Supertip>
      <Icon>
        <bt:Image size="16" resid="red-icon-16" />
        <bt:Image size="32" resid="red-icon-32" />
        <bt:Image size="80" resid="red-icon-80" />
      </Icon>
      <Action xsi:type="ExecuteFunction">
        <FunctionName>getItemClass</FunctionName>
      </Action>
    </Item>
  </Items>
</Control>
  • Last updated on