Command, elemento

Representa una definición 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	Obligatorio	Descripción
Comment	xs:string	No	Se usa para anotar el elemento de comando. (xs:string) Cadena compuesta por cualquier secuencia de caracteres, incluidos el espacio en blanco y los caracteres de salto de línea. Longitud máxima: 250 caracteres.
Id	xs:positiveInteger union xs:string	No	Identificador de recurso único. (Unión de xs:positiveInteger y xs:string) Valor entero entre 2 y 59999, inclusive o 0x2 y 0xea5f en hexadecimal, ambos inclusive. La longitud máxima es de 10 caracteres, incluidos ceros a la izquierda opcionales.
Información sobre claves	xs:string	No	Cadena que representa el método abreviado de teclado de un elemento de comando. (xs:string) Cadena compuesta por cualquier secuencia de caracteres, incluido el espacio en blanco.
LabelDescription	xs:string	No	Cadena que representa el texto mostrado en un elemento de comando. (xs:string) Cadena compuesta por cualquier secuencia de caracteres, incluidos el espacio en blanco y los caracteres de salto de línea.
LabelTitle	xs:string	No	Cadena que representa el texto mostrado en un elemento de comando. (xs:string) Cadena compuesta por cualquier secuencia de caracteres, incluidos el espacio en blanco y los caracteres de salto de línea.
Nombre	xs:string	No	(xs:string) Cadena que consta de una letra o un carácter de subrayado seguidos de cualquier secuencia de dígitos, letras o caracteres de subrayado. Longitud máxima: 100 caracteres.
Símbolo	xs:string	No	(xs:string) Cadena que consta de una letra o un carácter de subrayado seguidos de cualquier secuencia de dígitos, letras o caracteres de subrayado. Longitud máxima: 100 caracteres.
TooltipDescription	xs:string	No	Cadena que representa el texto mostrado en un elemento de comando. (xs:string) Cadena compuesta por cualquier secuencia de caracteres, incluidos el espacio en blanco y los caracteres de salto de línea.
TooltipTitle	xs:string	No	Cadena que representa el texto mostrado en un elemento de comando. (xs:string) Cadena compuesta por cualquier secuencia de caracteres, incluidos el espacio en blanco y los caracteres de salto de línea.

Elementos secundarios

Elemento	Descripción
Command.Comment	Puede producirse como máximo una vez
Command.Id	Puede producirse como máximo una vez
Command.Keytip	Puede producirse como máximo una vez
Command.LabelDescription	Puede producirse como máximo una vez
Command.LabelTitle	Puede producirse como máximo una vez
Command.LargeHighContrastImages	Puede producirse como máximo una vez
Command.LargeImages	Puede producirse como máximo una vez
Command.Name	Puede producirse como máximo una vez
Command.SmallHighContrastImages	Puede producirse como máximo una vez
Command.SmallImages	Puede producirse como máximo una vez
Command.Symbol	Puede producirse como máximo una vez
Command.TooltipDescription	Puede producirse como máximo una vez
Command.TooltipTitle	Puede producirse como máximo una vez

Elementos primarios

Elemento
Application.Commands

Comentarios

Necesario.

Puede producirse una o varias veces para cada elemento Application.Commands .

Los elementos secundarios del elemento Command pueden producirse en cualquier orden.

Normalmente, los recursos command se declaran en el marcado de la cinta de opciones, pero también se pueden establecer en tiempo de ejecución con una llamada a SetUICommandProperty. Por ejemplo, es posible establecer la propiedad UI_PKEY_Keytip para un comando en lugar de declarar un valor en el marcado con el elemento Command.Keytip .

En los casos en los que las propiedades Command, como las etiquetas y las imágenes, no se pueden establecer con SetUICommandProperty , se pueden invalidar con una llamada a InvalidateUICommand. Después de la invalidación, el marco consulta la aplicación host para obtener los detalles del recurso.

Nota

Un recurso no se puede restablecer desde la tabla de recursos de marcado después de que se haya invalidado.

Se agrega una definición de comando al archivo de encabezado de marcado de la cinta de opciones para cada comando declarado en marcado.

El valor de Keytip actúa como el acelerador de teclado de un comando a menos que ese comando se exponga a través de un elemento de menú. En este caso, el marco omite el valor keytip y, en su lugar, usa un carácter precedido por una y comercial como se especifica en LabelTitle o UI_PKEY_Label. Si no se especifica ninguna y comercial mediante LabelTitle o UI_PKEY_Label, no se expone ninguna información sobre teclas ni acelerador de teclado.

Ejemplos

En el ejemplo siguiente se muestra un manifiesto de elementos Command para una pestaña Inicio .

<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>

Información de elemento

• Sistema mínimo admitido: Windows 7
• Puede estar vacío: No