Prvek tlačítek
Definuje prvek, se kterým může uživatel pracovat. Tlačítka můžou být různých druhů: Button, MenuButton a SplitDropDown.
Syntaxe
<Button guid="guidMyCommandSet" id="MyCommand" priority="0x102" type="button">
<Parent>... </Parent>
<Icon>... </Icon>
<CommandFlag>... </CommandFlag>
<Strings>... </Strings>
</Button>
Atributy a prvky
Následující části popisují atributy, podřízené prvky a nadřazené prvky.
Atributy
Atribut | Popis |
---|---|
guid | Povinný: GUID identifikátoru příkazu GUID/ID. |
ID | Povinný: ID identifikátoru příkazu GUID/ID. |
Prioritou | Nepovinné. Číselná hodnota, která určuje prioritu. |
type | Nepovinné. Výčtová hodnota, která určuje typ tlačítka. Pokud není zadaný, použije tlačítko. Tlačítko Standardní příkaz, který se zobrazí na panelech nástrojů (obvykle jako ikonické tlačítko), nabídky a místní nabídky. Tlačítko nabídky Položka nabídky, která nespustí příkaz, ale vytvoří jinou nabídku. SplitDropDown Ovládací prvky, jako jsou tlačítka Zpět a Znovu na standardním panelu nástrojů v Microsoft Wordu. |
Podmínka | Nepovinné. Viz Podmíněné atributy. |
Podřízené prvky
Element (Prvek) | Popis |
---|---|
Nadřazený prvek | Nepovinné. Nadřazený prvek tlačítka. |
Element Icon | Nepovinné. Ikona přidružená k tlačítku. |
Element příznaku příkazu | Povinný: Platné hodnoty CommandFlag pro tlačítko jsou následující. - 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 |
Strings – element | Povinný: Podřízený element ButtonText musí být definován. |
Poznámka | Volitelný komentář. |
Nadřazené prvky
Element (Prvek) | Popis |
---|---|
Buttons – element | Prvky tlačítka skupiny. |
Příklad
Následující příklad definuje tlačítko v souboru .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>