Menu Aplicativo

O Menu do Aplicativo é o menu principal de um aplicativo que implementa a estrutura da Faixa de Opções do Windows.

• introdução
• componentes do menu de aplicativo
  • Menu Menu Grupo de Menus do Aplicativo
• dimensionar o menu do aplicativo
• Propriedades do menu do aplicativo
• tópicos relacionados

Introdução

O Menu do Aplicativo é composto por um controle de botão suspenso que exibe um menu que contém comandos que expõem a funcionalidade relacionada a um projeto completo, como um documento inteiro, uma imagem ou um filme. Os exemplos incluem os comandos New, Open, Savee Exit.

A captura de tela a seguir ilustra o Menu do Aplicativo.

Componentes do menu Aplicativo

O Menu do Aplicativo é um elemento obrigatório em qualquer aplicativo da Faixa de Opções. O ponto de entrada no Menu do Aplicativo é um botão distinto que aparece como o primeiro item na linha guia, conforme mostrado na captura de tela a seguir.

Quando clicado, este botão exibe o menu avançado mostrado na captura de tela a seguir (o Menu de Aplicativo do WordPad para Windows 7).

O Menu do Aplicativo contém dois painéis: uma lista de comandos representados por um ou mais elementosMenuGroupe uma lista Itens Recentes representados por um elementoApplicationMenu.RecentItems.

Menu Grupo de Menus do Aplicativo

O elemento ApplicationMenu deve conter pelo menos um elemento MenuGroup filho que expõe uma lista de comandos no nível do aplicativo. Se vários MenuGroup elementos forem declarados, uma linha divisora será desenhada entre os grupos, conforme mostrado na captura de tela a seguir.

Veja a seguir uma lista de restrições para um elemento MenuGroup de um Menu de Aplicativo:

• Todos os itensMenuGroupdevem ser declarados com um valor de atributo de classe de MajorItems.

• Um menu de aplicativo MenuGroup dá suporte apenas aos controles Button, Drop-Down Button, Split Button, Drop-Down Gallerye Split Button Gallery.

  ! [Importante]
  As galerias de comandos são o único tipo de galeria com suporte no Menu do Aplicativo. Consulte Trabalhando com Galerias, para obter mais informações sobre controles da galeria.

   

Quando um Button é usado em umMenuGroup, o valor de Command.LabelTitle é exibido no menu e os valores de Command.TooltipTitle e Command.TooltipDescription são exibidos como a dica de ferramenta, conforme mostrado na captura de tela a seguir.

Quando um Drop-Down Button, Split Button, Drop-Down Galleryou Split Button Gallery é usado no Menu aplicativo, a parte do menu é exibida como um submenu que cobre e oculta o painel Itens recentes.

Para controles botão dividir e Drop-Down button, o valor de Command.LabelDescription é mostrado embutido no menu de submenu para ajudar visualmente os usuários a descobrir a funcionalidade comando. O valor exibido de Command.LabelDescription é dividido programaticamente em um intervalo de duas linhas e é feita uma tentativa de ajustar o valor exatamente sobre os itens Recentes painel abaixo. Se o valor Command.LabelDescription do não se ajustar, o submenu será expandido para acomodar o valor mais longo Command.Comment namenuGroup.

A captura de tela a seguir ilustra esses comportamentos em um submenu botão dividir.

Com uma galeria de Drop-Down e um galeria de botões divididos, apenas um rótulo e uma imagem são mostrados.

Dimensionando o menu aplicativo

O dimensionamento do Menu do Aplicativo é tratado pela estrutura da Faixa de Opções. Se forem fornecidas cadeias de caracteres muito longas para o valor de Command.LabelTitle ou Command.LabelDescriptionou uma longa lista de comandos for usada, o menu ajustará seu tamanho para acomodar o conteúdo. Algumas formas de ajuste incluem expandir o tamanho de submenus ou painéis de menu e adicionar visualizadores de painel quando a rolagem é necessária.

Propriedades do Menu do Aplicativo

A estrutura da Faixa de Opções define uma coleção de chaves de propriedade para o controle Menu do Aplicativo.

Normalmente, uma propriedade menu de aplicativo é atualizada na interface do usuário da faixa de opções invalidando o comando associado ao controle por meio de uma chamada para o método IUIFramework::InvalidateUICommand. O evento de invalidação é tratado e as atualizações de propriedade são definidas pelo método de retorno de chamada IUICommandHandler::UpdateProperty.

O método de retorno de chamada IUICommandHandler::UpdateProperty não é executado e o aplicativo não é consultado quanto a um valor de propriedade atualizado até que a propriedade seja exigida pela estrutura. Por exemplo, a estrutura requer a propriedade quando uma guia é ativada e um controle é revelado na interface do usuário da faixa de opções ou quando uma dica de ferramenta é exibida.

Tópicos relacionados

biblioteca de controle da Estrutura da Faixa de Opções do Windows

elemento de marcação ApplicationMenu