Button-Element

Artikel
05/16/2015

Definiert ein Element, das der Benutzer interagieren kann. Es gibt vier Arten von Tasten wie folgt: Schaltfläche SplitDropDown, MenuButton und das Feld.

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
guid	Erforderlich. Die GUID des GUID-/ID Befehlskennzeichens.
id	Erforderlich. ID des GUID-/IDBefehlskennzeichens.
priority	Optional. Ein numerischer Wert, der die Priorität angibt.
type	Optional. Ein Enumerationswert, der den Typ der Schaltfläche angibt. Wenn nicht angegeben, verwendet. Button Ein Befehl, der auf der Symbolleiste Standard (i. d. R. als ikonenhafte Schaltfläche), Menüs und Kontextmenüs angezeigt wird. MenuButton Ein Menüelement, das keinen Befehl ausführt, sondern legt ein anderes Menü vor. SplitDropDown Steuert, wie der Rückgängig- und Wiederholen Schaltflächen auf der Symbolleiste Standard in Microsoft Word.
Bedingung	Optional. Weitere Informationen finden Sie unter Bedingte Attribute für das VSCT-XML-Schema.

Untergeordnete Elemente

Parent-Element

Optional. Das übergeordnete Element der Schaltfläche.

Icon-Element

Optional. Das Symbol mit der Schaltfläche.

Command Flag-Element

Erforderlich. Die gültigen CommandFlag-Werte für eine Schaltfläche lauten wie folgt:

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

Erforderlich. Untergeordnete ButtonText-Element muss definiert werden.

Anmerkung

Optionaler Kommentar.

Übergeordnete Elemente

Element	Beschreibung
Buttons-Element	Gruppen-Schaltflächen Elemente.

Beispiel

Im folgenden Beispiel wird eine Schaltfläche in einer .vsct-Datei.

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

Siehe auch

Weitere Ressourcen

(Visual Studio-Befehls-Tabelle. Dateien Vsct)

Freigeben über