Compartilhar via

Elemento Command

  • Artigo

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