Escutando eventos da faixa de opções
A estrutura da Faixa de Opções do Windows usa a infraestrutura ETW (Rastreamento de Eventos para Windows) para permitir que os desenvolvedores aprendam como os usuários estão interagindo com a faixa de opções do aplicativo.
Introdução
O mecanismo de evento da estrutura da Faixa de Opções foi projetado para que a estrutura reporte eventos de interface do usuário da faixa de opções ao aplicativo para que você possa monitorar a atividade do usuário, aprender seus padrões de interação e avaliar tendências de uso. Essas informações podem ser usadas para refinar a experiência do usuário para iterações futuras do seu aplicativo de faixa de opções.
O uso dos eventos da estrutura da Faixa de Opções envolve o seguinte:
- O aplicativo da faixa de opções deve registrar um ouvinte ETW (Rastreamento de Eventos para Windows) para receber notificações de evento da faixa de opções da estrutura da Faixa de Opções.
- A estrutura da Faixa de Opções aciona os retornos de chamada de evento da interface do usuário da faixa de opções em tempo de execução, se o aplicativo tiver registrado um ouvinte etw (Rastreamento de Eventos para Windows ).
Eventos com suporte
Os eventos expostos a aplicativos de faixa de opções são descritos na tabela a seguir.
| Evento | Relatório de eventos |
|---|---|
| Guia ativada | ID de Comando Nome de comando Verbo de evento |
| Guia contextual ativada | ID de Comando Nome de comando Verbo de evento |
| Menu aplicativo aberto | Verbo de evento |
| Menu aplicativo fechado | Verbo de evento |
| Menu (regular ou galeria) aberto | ID de Comando Nome de comando Verbo de evento Nota: Os eventos do menu QAT não são expostos. |
| Menu (regular ou galeria) fechado | ID de Comando Nome de comando Verbo de evento Nota: Os eventos do menu QAT não são expostos. |
| Comando | ID de Comando Nome de comando Verbo de evento Um dos seguintes locais de evento: -FITA - QUICKACCESSTOOLBAR - APPLICATIONMENU - CONTEXTPOPUP ID do comando pai Nome do comando pai Um dos seguintes métodos de invocação: -CLIQUE -KEYTIP -TECLADO -TOQUE Nota: Galerias de itens e caixas de combinação incluem o índice de item selecionado, mas não incluem valores de cadeia de caracteres e inteiros. Os spinners não incluem o valor inteiro. |
| Faixa de opções minimizada | Verbo de evento |
| Faixa de opções expandida (botão expandir clicado ou toque fixado) | Verbo de evento |
| Modo de aplicativo alternado | Verbo de evento ID do modo (valor definido por meio de SetModes) Nota: O aplicativo é responsável por desempacotar esse inteiro para determinar quais modos foram definidos. |
| Dica de ferramenta exibida | Verbo de evento ID do comando pai Nome do comando pai |