Freigeben über

Schaltflächenelement

  • Artikel

Definiert ein Element, mit dem der Benutzer interagieren kann. Schaltflächen können unterschiedlich sein: Schaltflächen, MenuButton und SplitDropDown.

Syntax

<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. GUID des GUID/ID-Befehlsbezeichners.
id Erforderlich. ID des GUID/ID-Befehlsbezeichners.
priority Optional. Ein numerischer Wert, der die Priorität angibt.
Typ Optional. Ein aufgezählter Wert, der die Art der Schaltfläche angibt.

Wenn nicht angegeben, verwendet "Button".

Schaltfläche
Ein Standardbefehl, der auf Symbolleisten (in der Regel als Iconic-Schaltfläche), Menüs und Kontextmenüs angezeigt wird.

MenuButton
Ein Menüelement, das keinen Befehl ausführt, sondern ein anderes Menü erzeugt.

SplitDropDown
Steuerelemente, z. B. die Schaltflächen "Rückgängig" und "Wiederholen" auf der Standardsymbolleiste in Microsoft Word.
Bedingung Optional. Siehe Bedingte Attribute.

Untergeordnete Elemente

Element Beschreibung
Übergeordnetes Element Optional. Das übergeordnete Element der Schaltfläche.
Icon-Element Optional. Das Symbol, das der Schaltfläche zugeordnet ist.
Befehlskennzeichnungselement Erforderlich. Die gültigen CommandFlag-Werte für eine Schaltfläche sind wie folgt.

- AllowParams

- CommandWellOnly

- DefaultDisabled

- DefaultInvisible

- DontCache

- DynamicItemStart

- Dynamische Sichtbarkeit

- FixMenuController

- IconAndText

- NoButtonCustomize

- NoCustomize

- NoKeyCustomize

- NoShowOnMenuController

-Pict

- PostExec

- ProfferedCmd

- RouteToDocs

- TextCascadeUseBtn

- TextMenuUseButton

- TextChanges

- TextChangesButton

- TextContextUseButton

- TextMenuCtrlUseMenu

- TextMenuUseButton

- TextOnly
Strings-Element Erforderlich. Das untergeordnete ButtonText-Element muss definiert werden.
Anmerkung Optionaler Kommentar.

Übergeordnete Elemente

Element Beschreibung
Buttons-Element Gruppenschaltflächenelemente.

Beispiel

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

<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