Elemento de controle do tipo Menu

Um menu define uma lista de opções. Cada item de menu executa uma função ou mostra um painel de tarefas.

Observação

Este artigo pressupõe familiaridade com o artigo de referência de Controle básico, que contém informações importantes sobre os atributos do elemento.

O controle de menu define:

  • Um controle de menu de nível raiz.
  • Uma lista de itens de menu.

Quando usado com o ponto de extensão PrimaryCommandSurface, o item do menu raiz é exibido como um botão na faixa de opções. Quando o botão é selecionado, o menu é exibido como uma lista suspensa. Não há suporte para submenus.

Quando usado com o ponto de extensão ContextMenu, um item do menu raiz é exibido no menu de contexto. Quando o item raiz é selecionado, os itens de menu são exibidos como um submenu. Nenhum dos itens pode ser um submenu porque há suporte para apenas um nível de submenus.

Elementos filho

Elemento Obrigatório Descrição
Label Sim O texto para o menu.
Supertip Sim A superdica para este menu.

Importante: as Supertips só têm suporte em clientes de desktop do Office.
Icon Sim Uma imagem para o menu.
<Itens> Sim Uma coleção de itens a serem exibidos no menu. Contém o <elemento Item> para cada item.
OverriddenByRibbonApi Não Especifica se o menu deve aparecer em combinações de aplicativo e plataforma que dão suporte a guias contextuais personalizadas. Se usado, ele deve ser o primeiro elemento filho.

Rótulo

Especifica o texto do nome do menu por meio de seu único atributo, resid, que não pode ter mais de 32 caracteres e deve ser definido como o valor do atributo id de um <elemento String> no <filho ShortStrings> do elemento Resources .

Tipo de suplemento: Painel de tarefas, Email

Válido somente nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0
  • Email 1.0
  • Email 1.1

Para obter mais informações, consulte Substituições de versão no manifesto somente do suplemento.

Associado a estes conjuntos de requisitos:

Exemplos

No exemplo a seguir, o menu tem dois itens. O primeiro exibe um painel de tarefas. O segundo executa uma função. O menu foi configurado para não ficar visível quando o suplemento estiver em execução em uma plataforma com suporte para guias contextuais. Para obter mais informações, consulte Implementar uma experiência de interface do usuário alternativa quando não há suporte para guias contextuais personalizadas.

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

No exemplo a seguir, o segundo item do menu está configurado para não ficar visível quando o suplemento estiver em execução em uma plataforma com suporte para guias contextuais. Para obter mais informações, consulte Implementar uma experiência de interface do usuário alternativa quando não há suporte para guias contextuais 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>
  • Last updated on