Elemento Command

  • Articolo

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