Elemento Command

Representa uma definição de comando.

Uso

<Command
  Name = "xs:string"
  Symbol = "xs:string"
  Id = "xs:positiveInteger union xs:string"
  Comment = "xs:string"
  LabelTitle = "xs:string"
  LabelDescription = "xs:string"
  TooltipTitle = "xs:string"
  TooltipDescription = "xs:string"
  Keytip = "xs:string">
  child elements
</Command>

Atributos

Atributo	Tipo	Obrigatório	Descrição
Comentário	xs:string	Não	Usado para anotar o elemento de comando. (xs:string) Uma cadeia de caracteres composta por qualquer sequência de caracteres, incluindo espaço em branco e caracteres de quebra de linha. Comprimento máximo: 250 caracteres.
Id	xs:positiveInteger union xs:string	Não	A ID do recurso exclusivo. (A união de xs:positiveInteger e xs:string) Um valor inteiro entre 2 e 59999, inclusive ou 0x2 e 0xea5f em hexadecimal, inclusive. O comprimento máximo é de 10 caracteres, incluindo zeros à esquerda opcionais.
Keytip	xs:string	Não	Uma cadeia de caracteres que representa o atalho de teclado de um elemento de comando. (xs:string) Uma cadeia de caracteres composta por qualquer sequência de caracteres, incluindo espaço em branco.
LabelDescription	xs:string	Não	Uma cadeia de caracteres que representa o texto exibido em um elemento de comando. (xs:string) Uma cadeia de caracteres composta por qualquer sequência de caracteres, incluindo espaço em branco e caracteres de quebra de linha.
LabelTitle	xs:string	Não	Uma cadeia de caracteres que representa o texto exibido em um elemento de comando. (xs:string) Uma cadeia de caracteres composta por qualquer sequência de caracteres, incluindo espaço em branco e caracteres de quebra de linha.
Nome	xs:string	Não	(xs:string) Uma cadeia de caracteres que consiste em uma letra ou sublinhado seguido por qualquer sequência de dígitos, letras ou sublinhados. Comprimento máximo: 100 caracteres.
Símbolo	xs:string	Não	(xs:string) Uma cadeia de caracteres que consiste em uma letra ou sublinhado seguido por qualquer sequência de dígitos, letras ou sublinhados. Comprimento máximo: 100 caracteres.
TooltipDescription	xs:string	Não	Uma cadeia de caracteres que representa o texto exibido em um elemento de comando. (xs:string) Uma cadeia de caracteres composta por qualquer sequência de caracteres, incluindo espaço em branco e caracteres de quebra de linha.
Tooltiptitle	xs:string	Não	Uma cadeia de caracteres que representa o texto exibido em um elemento de comando. (xs:string) Uma cadeia de caracteres composta por qualquer sequência de caracteres, incluindo espaço em branco e caracteres de quebra de linha.

Elementos filho

Elemento	Descrição
Command.Comment	Pode ocorrer no máximo uma vez
Command.Id	Pode ocorrer no máximo uma vez
Command.Keytip	Pode ocorrer no máximo uma vez
Command.LabelDescription	Pode ocorrer no máximo uma vez
Command.LabelTitle	Pode ocorrer no máximo uma vez
Command.LargeHighContrastImages	Pode ocorrer no máximo uma vez
Command.LargeImages	Pode ocorrer no máximo uma vez
Command.Name	Pode ocorrer no máximo uma vez
Command.SmallHighContrastImages	Pode ocorrer no máximo uma vez
Command.SmallImages	Pode ocorrer no máximo uma vez
Command.Symbol	Pode ocorrer no máximo uma vez
Command.TooltipDescription	Pode ocorrer no máximo uma vez
Command.TooltipTitle	Pode ocorrer no máximo uma vez

Elementos pai

Elemento
Application.Commands

Comentários

Obrigatórios.

Pode ocorrer uma ou mais vezes para cada elemento Application.Commands .

Os elementos filho do elemento Command podem ocorrer em qualquer ordem.

Normalmente, os recursos de comando são declarados na marcação da Faixa de Opções, mas também podem ser definidos em tempo de execução com uma chamada para SetUICommandProperty. Por exemplo, é possível definir a propriedade UI_PKEY_Keytip para um Command em vez de declarar um valor na marcação com o elemento Command.Keytip .

Nos casos em que as propriedades Command, como rótulos e imagens, não podem ser definidas com SetUICommandProperty , elas podem ser invalidadas com uma chamada para InvalidateUICommand. Após a invalidação, a estrutura consulta o aplicativo host para obter os detalhes do recurso.

Observação

Um recurso não pode ser restabelecido da tabela de recursos de marcação depois de invalidado.

Uma definição de comando é adicionada ao arquivo de cabeçalho de marcação da Faixa de Opções para cada Comando declarado na marcação.

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

Exemplos

O exemplo a seguir mostra um manifesto de elementos Command para uma guia Página Inicial .

<Application.Commands>

<Command Name="cmdHomeTab"
         LabelTitle="Home"
         Keytip="H" />
<Command Name="cmdClipboardGroup"
         Symbol="IDR_CMD_CLIPBOARD"
         Id="10000"
         Comment="Command definition for clipboard group"
         LabelTitle="Clipboard"
         Keytip="CB" />
<Command Name="cmdCopy"
         Symbol="IDR_CMD_COPY"
         LabelTitle="Copy"
         LabelDescription="Copy"
         Keytip="C"
         TooltipTitle="Copy"
         TooltipDescription="Click to copy">
  <Command.SmallImages>
    <Image>res/copyS_16.bmp</Image>
  </Command.SmallImages>
  <Command.LargeImages>
    <Image>res/copyL_32.bmp</Image>
  </Command.LargeImages>
</Command>
<Command Name="cmdPaste"
         Symbol="IDR_CMD_PASTE" >
  <Command.LabelTitle>Paste</Command.LabelTitle>
  <Command.LabelDescription>
    <String Content="Paste contents of clipboard"
            Id="10001"
            Symbol="IDR_RES_LABELDESC_PASTE" />
  </Command.LabelDescription>
  <Command.Keytip>P</Command.Keytip>
  <Command.TooltipTitle>
    <String Content="Paste contents of clipboard"
            Id="10002"
            Symbol="IDR_RES_TOOLTIP_PASTE"/>
  </Command.TooltipTitle>
  <Command.TooltipDescription>
    <String Content="Click to paste contents of clipboard"/>
  </Command.TooltipDescription>
  <Command.SmallImages>
    <Image
      Id="10010"
      MinDPI="96"
      Symbol="IDR_RES_SMALL_IMAGE96">
      <Image.Source>res/pasteS_96bpp.bmp</Image.Source>
    </Image>
    <Image Source="res/pasteS_120bpp.bmp"
           Id="10011"
           MinDPI="120"
           Symbol="IDR_RES_SMALL_IMAGE120" />
  </Command.SmallImages>
  <Command.LargeImages>
    <Image>res/pasteL_32.bmp</Image>
  </Command.LargeImages>
</Command>
<Command Name="cmdMinimize"
         Symbol="IDR_CMD_MINIMIZE"
         Id="10001"
         LabelTitle="Minimize" />

</Application.Commands>

Informações do elemento

• Sistema mínimo com suporte: Windows 7
• Pode estar vazio: Não