Compartilhar via


Menu Aplicativo

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

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, imagem ou filme. Os exemplos incluem os comandos Novo, Abrir, Salvar e Sair .

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

captura de tela do menu do aplicativo e da lista de itens recentes da faixa de opções tinta para windows 7.

Componentes do Menu do 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 Tab , conforme mostrado na captura de tela a seguir.

Observação

Windows 8 e mais recente: imagem do botão Menu do Aplicativo alterada para rótulo: Arquivo. Recomendamos que você não use Arquivo como o rótulo para qualquer uma de suas próprias guias.

 

captura de tela do botão de menu do aplicativo do wordpad para windows 7.

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

captura de tela do menu de menu do aplicativo do wordpad para windows 7.

Observação

Não há nenhum impacto na guia definida quando o botão Menu do Aplicativo é clicado; em vez disso, o foco entra no menu.

 

O Menu do Aplicativo contém dois painéis: uma lista de Comandos representados por um ou mais elementos MenuGroup e uma lista Itens Recentes representada por um elemento ApplicationMenu.RecentItems .

Menu Menu AplicativoGrupo

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

captura de tela de um grupo de menus de aplicativo.

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

Quando um Botão é usado em um MenuGroup, 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.

captura de tela de um controle de botão em um menu de aplicativo.

Quando um Botão Suspenso, Botão Dividir, Galeria Suspensa ou Galeria de Botões Divididos é usado no Menu aplicativo, a parte do menu é exibida como um submenu que abrange e oculta o painel Itens recentes .

Para controles De botão dividir e botão suspenso , 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 o painel Itens recentes abaixo. Se o valor Command.LabelDescription não se ajustar, o submenu será expandido para acomodar o valor Command.Comment mais longo no MenuGroup.

A captura de tela a seguir ilustra esses comportamentos em um submenu Dividir Botão .

captura de tela de um submenu de controle de lista em um menu de aplicativo.

Com uma Galeria Suspensa e uma Galeria de Botões Divididos, apenas um rótulo e uma imagem são mostrados.

Dimensionar o Menu do Aplicativo

O dimensionamento do Menu do Aplicativo é tratado pela estrutura da Faixa de Opções. Se cadeias de caracteres muito longas forem fornecidas para o valor de Command.LabelTitle ou Command.LabelDescription, ou 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 por 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.

Chave de propriedade Observações
UI_PKEY_TooltipDescription Só pode ser atualizado por meio de invalidação.
UI_PKEY_TooltipTitle Só pode ser atualizado por meio de invalidação.

 

Biblioteca de Controle da Estrutura da Faixa de Opções do Windows

Elemento de marcação ApplicationMenu