Compartilhar via

Elemento controle do tipo Menu

  • Artigo

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 de 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 de 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 do menu.
<Tooltip> Não A dica de ferramenta do menu. O atributo resid não pode ter mais de 32 caracteres e deve ser definido como o valor do atributo id de um <elemento String> . O <elemento String> é filho do <elemento LongStrings> , que é filho do elemento Resources .
Supertip Sim A super dica para este menu.

Importante: as supertipas só têm suporte em clientes da área de trabalho 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 para o 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.

Associado a esses 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 que dá suporte a guias contextuais. Para obter mais informações, consulte Implementar uma experiência alternativa de interface do usuário quando não há suporte para guias contextuais 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>

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