Compartilhar via

Propriedade Command.Keytip

  • Artigo

Representa a dica de chave de um controle.

Uso

<Command.Keytip>
  child elements
</Command.Keytip>

Atributos

Não há atributos.

Elementos filho

Elemento Descrição
String
 Pode ocorrer no máximo uma vez

Elementos pai

Elemento
Comando

Comentários

Opcional.

Pode ocorrer no máximo uma vez para cada elemento Command .

Command.Keytip pode conter um valor do tipo xs:string restrito a qualquer sequência de caracteres Unicode, incluindo espaço em branco.

Uma Command.Keytip pode começar com um número somente quando associada a um controle em uma Guia ou na Barra de Ferramentas de Acesso Rápido.

Para exibir as dicas de tecla válidas para o estado atual da faixa de opções, pressione e segure a tecla ALT. A captura de tela a seguir mostra as dicas de tecla iniciais ou de primeiro nível exibidas no Microsoft Paint para Windows 7. Depois que uma dica de chave de primeiro nível tiver sido selecionada, somente as dicas de chave de segundo nível serão exibidas.

dicas de chave de primeiro nível no Microsoft Paint para Windows 7

Command.Keytip atua como o acelerador de teclado de um comando, a menos que esse comando seja exposto por meio de um item de menu. Nesse caso, a estrutura ignora o valor Command.Keytip e, em vez disso, usa um caractere precedido por um e comercial, conforme especificado por Command.LabelTitle ou UI_PKEY_Label. Se nenhum e comercial for especificado por Command.LabelTitle ou UI_PKEY_Label, nenhuma dica de tecla ou acelerador de teclado será exposta.

Se nenhum valor for fornecido para Command.Keytip, o elemento filho String será necessário.

Observação

Se Command.Keytip contiver um valor e um elemento filho String , String terá precedência.

Por padrão, as seguintes letras são usadas pela estrutura para gerar automaticamente dicas de chave:

Observação

Nenhuma dessas letras é reservada pela estrutura. Cada um pode ser atribuído a um ou mais comandos conforme necessário.

A estrutura resolve conflitos de dica de chave das seguintes maneiras:

  • Se um ou mais controles Tab estiverem associados à mesma dica de chave, um número será acrescentado a cada dica de chave, começando em 1 e aumentando sequencialmente (2, 3,...) para cada controle na ordem de declaração. Se algum controle Tab receber a letra F como uma dica de tecla, o Menu do Aplicativo será atribuído a F1 com as dicas de tecla restantes ajustadas conforme descrito.
  • Quando associada a um único controle dentro de uma Guia, a dica de tecla F é válida para o controle e o Menu do Aplicativo. A dica de chave padrão do Menu do Aplicativo não é alterada, mas a precedência é dada ao controle na guia ativa.
  • Se um ou mais controles em uma Guia estiverem associados à mesma dica de chave, a estrutura refatora automaticamente as dicas de chave desses controles, conforme descrito anteriormente.

Observação

Uma pequena variação na cor do texto é usada para realçar as dicas de chave refatoradas em uma implementação de faixa de opções padrão. Para uma implementação de faixa de opções não padrão em que a cor da faixa de opções foi personalizada, esse comportamento de estrutura é substituído e todas as dicas de tecla são exibidas com a mesma cor de texto. Para obter mais informações, consulte Personalizando cores da faixa de opções.

O comprimento máximo é não associado.

Exemplos

O exemplo a seguir demonstra a marcação de um elemento Command com uma declaração Command.Keytip .

<Command>
  <Command.Name>cmdSave</Command.Name>
  <Command.Symbol>ID_FILE_SAVE</Command.Symbol>
  <Command.Comment>Save</Command.Comment>
  <Command.Id>25003</Command.Id>
  <Command.LabelTitle>
    <String>
      <String.Content>Label for Save</String.Content>
      <String.Id>59999</String.Id>
      <String.Symbol>strSave</String.Symbol>
    </String>
  </Command.LabelTitle>
  <Command.TooltipTitle>Tooltip title with &amp;&amp; for Save Command</Command.TooltipTitle>
  <Command.TooltipDescription>Tooltip description for Save Command.</Command.TooltipDescription>
  <Command.Keytip>s1</Command.Keytip>
</Command>

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2008 R2 [somente aplicativos da área de trabalho]

Confira também

UI_PKEY_Keytip