Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
O Menu Aplicativo é o menu principal de um aplicativo que implementa a estrutura da Faixa de Opções do Windows.
- Introdução
- componentes do menu do aplicativo
- dimensionamento do 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 contendo Comandos que expõem a funcionalidade relacionada a um projeto completo, como um documento, imagem ou filme inteiro. Os exemplos incluem o Nova, Abrir, Salvare Comandos Sair.
A captura de tela a seguir ilustra o menu Aplicativo.
Componentes do menu de aplicativos
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 da guia, conforme mostrado na captura de tela a seguir.
Observação
Windows 8 e versões mais recentes: imagem do botão Menu de aplicativos 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, esse botão exibe o menu avançado mostrado na captura de tela a seguir (o menu Aplicativo do WordPad para Windows 7).
Observação
Não há impacto no conjunto de guias 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 elementoApplicationMenu.RecentItems.
Menu do aplicativo MenuGroup
O elemento ApplicationMenu deve conter pelo menos um elemento filho MenuGroup que exponha uma lista de comandos no nível do aplicativo. Se vários elementos MenuGroup forem declarados, uma linha divisória será desenhada entre os grupos, conforme mostrado na captura de tela a seguir.
A seguir está uma lista de restrições para um MenuGroup elemento de um menu de aplicativo:
Todos os itensMenuGroup devem ser declarados com um valor de atributo Class de
MajorItems.Um Menu de Aplicação MenuGroup suporta apenas os controlos Button, Drop-Down Button, Split Button, Drop-Down Gallerye Split Button Gallery .
! [Importante]
As galerias de comandos são o único tipo de galeria suportado no Menu Aplicativo. Consulte Trabalhando com galerias, para obter mais informações sobre controles de 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 BotãoDrop-Down , Botão Dividir, Drop-Down Galeriaou Galeria de Botões Divididos é usado no Menu Aplicativo, a parte do menu é exibida como um submenu que cobre e oculta os Itens recentes painel.
Para Botão Dividido e controles BotãoDrop-Down, o valor de Command.LabelDescription é mostrado embutido no menu suspenso para ajudar visualmente os usuários a descobrir a funcionalidade Comando. O valor exibido de Command.LabelDescription é quebrado programaticamente em uma extensão de duas linhas e é feita uma tentativa de ajustar o valor exatamente sobre o Itens recentes painel abaixo. Se o valor Command.LabelDescription não se ajustar, o submenu será expandido para acomodar o valor deCommand.Comment demais longo noMenuGroup do.
A captura de tela a seguir ilustra esses comportamentos em um submenu Botão de Divisão do.
Com uma GaleriaDrop-Down e uma Galeria de botões divididos, apenas um rótulo e uma imagem são mostrados.
Dimensionando 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 se 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 panorâmica 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 Application Menu é atualizada na interface do usuário da faixa de opções invalidando o Command associado ao controle por meio de uma chamada para o IUIFramework::InvalidateUICommand método. O evento de invalidação é manipulado e as atualizações de propriedade são definidas pelo método de retorno de chamada IUICommandHandler::UpdateProperty IUICommandHandler.
O IUICommandHandler::UpdateProperty método de retorno de chamada não é executado e o aplicativo não é consultado para 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 da propriedade | Observações |
|---|---|
| UI_PKEY_TooltipDescription | Só pode ser atualizado através de invalidação. |
| UI_PKEY_TooltipTitle | Só pode ser atualizado através de invalidação. |
Tópicos relacionados