Compartir a través de


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