Compartilhar via


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