Condividi tramite

Elemento pulsante

  • Articolo

Definisce un elemento con cui l'utente può interagire. I pulsanti possono essere di diversi tipi: Pulsante, MenuButton e SplitDropDown.

Sintassi

<Button guid="guidMyCommandSet" id="MyCommand" priority="0x102" type="button">
  <Parent>... </Parent>
  <Icon>... </Icon>
  <CommandFlag>... </CommandFlag>
  <Strings>... </Strings>
</Button>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
guid Obbligatorio. GUID dell'identificatore di comando GUID/ID.
ID Obbligatorio. ID dell'identificatore di comando GUID/ID.
priority Facoltativo. Valore numerico che specifica la priorità.
type Facoltativo. Valore enumerato che specifica il tipo di pulsante.

Se non specificato, usa Button.

Pulsante
Comando standard visualizzato sulle barre degli strumenti (in genere come pulsante iconico), menu e menu di scelta rapida.

MenuButton
Voce di menu che non esegue un comando, ma produce un altro menu.

SplitDropDown
Controlli, ad esempio i pulsanti Annulla e Ripeti sulla barra degli strumenti standard di Microsoft Word.
Condizione Facoltativo. Vedere Attributi condizionali.

Elementi figlio

Elemento Descrizione
Elemento padre Facoltativo. Elemento padre del pulsante.
Elemento Icon Facoltativo. Icona associata al pulsante.
Elemento flag command Obbligatorio. I valori CommandFlag validi per un controllo Button sono i seguenti.

- AllowParams

- CommandWellOnly

- DefaultDisabled

- DefaultInvisible

- DontCache

- DynamicItemStart

- DynamicVisibility

- FixMenuController

- IconAndText

- NoButtonCustomize

- NoCustomize

- NoKeyCustomize

- NoShowOnMenuController

-Pict

- PostExec

- ProfferedCmd

- RouteToDocs

- TextCascadeUseBtn

- TextMenuUseButton

- TextChanges

- TextChangesButton

- TextContextUseButton

- TextMenuCtrlUseMenu

- TextMenuUseButton

- TextOnly
Elemento Strings Obbligatorio. L'elemento ButtonText figlio deve essere definito.
Annotazione Commento facoltativo.

Elementi padre

Elemento Descrizione
Elemento Buttons Raggruppa gli elementi Button.

Esempio

Nell'esempio seguente viene definito un pulsante in un file con estensione vsct .

<Button guid="guidMenuTextCmdSet" id="cmdidMyCommand" priority="0x0100" type="Button">
   <Parent guid="guidMenuTextCmdSet" id="MyMenuGroup" />
   <Icon guid="guidImages" id="bmpPic1" />
   <CommandFlag>TextChanges</CommandFlag>
   <Strings>
         <CommandName>cmdidMyCommand</CommandName>
         <ButtonText>My Command name</ButtonText>
   </Strings>
</Button>

Vedi anche