Condividi tramite


Elemento Command

Rappresenta una definizione di comando.

Utilizzo

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

Attributi

Attributo Type Obbligatoria Descrizione
Commento
xs:string
No
Usato per annotare l'elemento di comando.

(xs:string)
Stringa composta da qualsiasi sequenza di caratteri, inclusi spazi vuoti e caratteri di interruzione di riga.
Lunghezza massima: 250 caratteri.
Id
xs:positiveInteger union xs:string
No
ID risorsa univoco.

(Unione di xs:positiveInteger e xs:string)
Valore intero compreso tra 2 e 59999, inclusi o 0x2 e 0xea5f in esadecimale, inclusivo.
La lunghezza massima è di 10 caratteri, inclusi gli zeri iniziali facoltativi.
Keytip
xs:string
No
Stringa che rappresenta la scelta rapida da tastiera di un elemento di comando.

(xs:string)
Stringa composta da qualsiasi sequenza di caratteri, inclusi gli spazi vuoti.
LabelDescription
xs:string
No
Stringa che rappresenta il testo visualizzato in un elemento di comando.

(xs:string)
Stringa composta da qualsiasi sequenza di caratteri, inclusi spazi vuoti e caratteri di interruzione di riga.
LabelTitle
xs:string
No
Stringa che rappresenta il testo visualizzato in un elemento di comando.

(xs:string)
Stringa composta da qualsiasi sequenza di caratteri, inclusi spazi vuoti e caratteri di interruzione di riga.
Nome
xs:string
No
(xs:string)
Stringa costituita da una lettera o un carattere di sottolineatura seguito da qualsiasi sequenza di cifre, lettere o caratteri di sottolineatura.
Lunghezza massima: 100 caratteri.
Simbolo
xs:string
No
(xs:string)
Stringa costituita da una lettera o un carattere di sottolineatura seguito da qualsiasi sequenza di cifre, lettere o caratteri di sottolineatura.
Lunghezza massima: 100 caratteri.
Descrizione comandoDescription
xs:string
No
Stringa che rappresenta il testo visualizzato in un elemento di comando.

(xs:string)
Stringa composta da qualsiasi sequenza di caratteri, inclusi spazi vuoti e caratteri di interruzione di riga.
TooltipTitle
xs:string
No
Stringa che rappresenta il testo visualizzato in un elemento di comando.

(xs:string)
Stringa composta da qualsiasi sequenza di caratteri, inclusi spazi vuoti e caratteri di interruzione di riga.

Elementi figlio

Elemento Descrizione
Command.Comment
Può verificarsi al massimo una volta

Command.Id
Può verificarsi al massimo una volta

Command.Keytip
Può verificarsi al massimo una volta

Command.LabelDescription
Può verificarsi al massimo una volta

Command.LabelTitle
Può verificarsi al massimo una volta

Command.LargeHighContrastImages
Può verificarsi al massimo una volta

Command.LargeImages
Può verificarsi al massimo una volta

Command.Name
Può verificarsi al massimo una volta

Command.SmallHighContrastImages
Può verificarsi al massimo una volta

Command.SmallImages
Può verificarsi al massimo una volta

Command.Symbol
Può verificarsi al massimo una volta

Command.TooltipDescription
Può verificarsi al massimo una volta

Command.TooltipTitle
Può verificarsi al massimo una volta

Elementi padre

Elemento
Application.Commands

Commenti

Obbligatorio.

Può verificarsi una o più volte per ogni elemento Application.Commands .

Gli elementi figlio dell'elemento Command possono verificarsi in qualsiasi ordine.

In genere, le risorse comando vengono dichiarate nel markup della barra multifunzione, ma possono anche essere impostate in fase di esecuzione con una chiamata a SetUICommandProperty. Ad esempio, è possibile impostare la proprietà UI_PKEY_Keytip per un oggetto Command anziché dichiarare un valore nel markup con l'elemento Command.Keytip .

Nei casi in cui le proprietà del comando, ad esempio etichette e immagini, non possono essere impostate con SetUICommandProperty , possono essere invalidate con una chiamata a InvalidateUICommand. Dopo l'invalidazione, il framework esegue una query sull'applicazione host per i dettagli della risorsa.

Nota

Una risorsa non può essere ripristinata dalla tabella delle risorse di markup dopo che è stata invalidata.

Una definizione di comando viene aggiunta al file di intestazione di markup della barra multifunzione per ogni comando dichiarato nel markup.

Il valore di Descrizione comando funge da tasto di scelta rapida per un comando a meno che tale comando non venga esposto tramite una voce di menu. In questo caso, il framework ignora il valore keytip e usa invece un carattere preceduto da una e commerciale come specificato da LabelTitle o UI_PKEY_Label. Se non viene specificata alcuna e commerciale da LabelTitle o UI_PKEY_Label, non viene esposto alcun tasto di scelta rapida o tasto di scelta rapida.

Esempio

Nell'esempio seguente viene illustrato un manifesto degli elementi Command per una scheda Home .

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

Informazioni sull'elemento

  • Sistema minimo supportato: Windows 7
  • Può essere vuoto: No