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
- Componentes do Menu 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, imagem ou filme. Os exemplos incluem os comandos Novo, Abrir, Salvar e Sair .
A captura de tela a seguir ilustra o Menu do Aplicativo.
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.
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).
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.
Veja a seguir uma lista de restrições para um elemento MenuGroup de um Menu de Aplicativo:
Todos os itens MenuGroup devem ser declarados com um valor de atributo Class de
MajorItems.Um Menu menu de aplicativoGrupo dá suporte apenas aos controles Botão, Botão Suspenso, Botão Dividir, Galeria Suspensa e Galeria de Botões Divididos .
! [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 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.
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 .
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. |
Tópicos relacionados