Elemento Control de tipo Menu

Un menú define una lista de opciones. Cada elemento de menú ejecuta una función o muestra un panel de tareas.

Nota:

En este artículo se da por hecho que está familiarizado con el artículo de referencia básica control , que contiene información importante sobre los atributos del elemento.

El control de menú define:

• Control de menú de nivel raíz.
• Lista de elementos de menú.

Cuando se usa con el punto de extensión PrimaryCommandSurface, el elemento de menú raíz se muestra como un botón en la cinta de opciones. Cuando se selecciona el botón, el menú se muestra como una lista desplegable. No se admiten los submenús.

Cuando se usa con el punto de extensión ContextMenu, se muestra un elemento de menú raíz en el menú contextual. Cuando se selecciona el elemento raíz, los elementos de menú se muestran como un submenú. Ninguno de los elementos puede ser un submenú porque solo se admite un nivel de submenús.

Elementos secundarios

Elemento	Obligatorio	Descripción
Label	Sí	Texto para el menú.
<Descripción>	No	La información sobre herramientas del menú. El atributo resid no puede tener más de 32 caracteres y debe establecerse en el valor del atributo id de un <elemento String> . El <elemento String> es un elemento secundario del <elemento LongStrings> , que es un elemento secundario del elemento Resources .
Supertip	Sí	Supertip para este menú. Importante: Las supertips solo se admiten en clientes de escritorio de Office.
Icon	Sí	Una imagen para el menú.
<Artículos>	Sí	Colección de elementos que se van a mostrar en el menú. Contiene el <elemento Item> de cada elemento.
OverriddenByRibbonApi	No	Especifica si el menú debe aparecer en las combinaciones de aplicaciones y plataformas que admiten pestañas contextuales personalizadas. Si se usa, debe ser el primer elemento secundario.

Etiqueta

Especifica el texto del nombre del menú por medio de su único atributo, resid, que no puede tener más de 32 caracteres y debe establecerse en el valor del atributo id de un <elemento String> en el <elemento secundario ShortStrings> del elemento Resources .

Tipo de complemento: Panel de tareas, Correo

Solo es válido en estos esquemas VersionOverrides:

• Panel de tareas 1.0
• Correo 1.0
• Correo 1.1

Para obtener más información, vea Invalidaciones de versión en el manifiesto.

Asociado a estos conjuntos de requisitos:

• AddinCommands 1.1 cuando el elemento primario< VersionOverrides> es de tipo Panel de tareas 1.0.
• Buzón 1.3 cuando el elemento primario< VersionOverrides> es de tipo Mail 1.0.
• Buzón 1.5 cuando el elemento primario< VersionOverrides> es de tipo Mail 1.1.

Ejemplos

En el ejemplo siguiente, el menú tiene dos elementos. La primera muestra un panel de tareas. El segundo ejecuta una función. El menú se ha configurado para que no sea visible cuando el complemento se ejecuta en una plataforma que admite pestañas contextuales. Para obtener más información, vea Implementar una experiencia de interfaz de usuario alternativa cuando no se admiten pestañas contextuales personalizadas.

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

En el ejemplo siguiente, el segundo elemento del menú está configurado para que no sea visible cuando el complemento se ejecuta en una plataforma que admite pestañas contextuales. Para obtener más información, vea Implementar una experiencia de interfaz de usuario alternativa cuando no se admiten pestañas contextuales personalizadas.

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