Élément Control de type Menu

  • Article

Un menu définit une liste d’options. Chaque option de menu exécute une fonction ou affiche un volet Office.

Remarque

Cet article suppose que vous êtes familiarisé avec l’article de référence Control de base qui contient des informations importantes sur les attributs de l’élément.

Le contrôle de menu définit :

  • Contrôle de menu au niveau de la racine.
  • Liste des éléments de menu.

Lorsqu’il est utilisé avec le point d’extension PrimaryCommandSurface, l’élément de menu racine s’affiche sous la forme d’un bouton sur le ruban. Lorsque le bouton est sélectionné, le menu s’affiche sous forme de liste déroulante. Les sous-menus ne sont pas pris en charge.

Lorsqu’il est utilisé avec le point d’extension ContextMenu, un élément de menu racine s’affiche dans le menu contextuel. Lorsque l’élément racine est sélectionné, les éléments de menu s’affichent sous la forme d’un sous-menu. Aucun des éléments ne peut être lui-même un sous-menu, car un seul niveau de sous-menus est pris en charge.

Éléments enfants

Élément Obligatoire Description
Label Oui Texte du menu.
<Tooltip> Non Info-bulle du menu. L’attribut resid ne peut pas comporter plus de 32 caractères et doit être défini sur la valeur de l’attribut id d’un <élément String> . L’élément <String> est un enfant de l’élément <LongStrings> , qui est un enfant de l’élément Resources .
Supertip Oui Super-info pour ce menu.

Important : les super-infos ne sont prises en charge que dans les clients de bureau Office.
Icon Oui Image du menu.
<Articles> Oui Collection d’éléments à afficher dans le menu. Contient l’élément <Item> pour chaque élément.
OverriddenByRibbonApi Non Spécifie si le menu doit apparaître sur les combinaisons d’applications et de plateformes qui prennent en charge les onglets contextuels personnalisés. S’il est utilisé, il doit s’agir du premier élément enfant.

Étiquette

Spécifie le texte du nom du menu au moyen de son seul attribut, resid, qui ne peut pas comporter plus de 32 caractères et doit être défini sur la valeur de l’attribut id d’un <élément String> dans l’enfant< ShortStrings> de l’élément Resources.

Type de complément : Volet Office, Courrier

Valide uniquement dans les schémas VersionOverrides suivants :

  • Volet De tâches 1.0
  • Mail 1.0
  • Courrier 1.1

Pour plus d’informations, consultez Remplacements de version dans le manifeste.

Associé à ces ensembles de conditions requises :

Exemples

Dans l’exemple suivant, le menu comporte deux éléments. Le premier affiche un volet Office. Le second exécute une fonction. Le menu a été configuré pour ne pas être visible lorsque le complément s’exécute sur une plateforme qui prend en charge les onglets contextuels. Pour plus d’informations, consultez Implémenter une autre expérience d’interface utilisateur lorsque les onglets contextuels personnalisés ne sont pas pris en charge.

<Control xsi:type="Menu" id="Contoso.TestMenu2">
  <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
  <Label resid="residLabel3" />
  <Tooltip resid="residToolTip" />
  <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>

Dans l’exemple suivant, le deuxième élément du menu est configuré pour ne pas être visible lorsque le complément s’exécute sur une plateforme qui prend en charge les onglets contextuels. Pour plus d’informations, consultez Implémenter une autre expérience d’interface utilisateur lorsque les onglets contextuels personnalisés ne sont pas pris en charge.

<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>