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