Elemento Command

Articolo
06/13/2023

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

Condividi tramite