Command, elemento

  • Artículo

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