Combo-Element

Artikel
05/16/2015

Definiert den Befehlen, die in einem Kombinationsfeld angezeigt werden. Es gibt vier Arten Kombinationsfelder wie folgt: DropDownCombo, DynamicCombo, IndexCombo und MRUCombo.

<combo guid="guidMyCommandSet" id="MyCommand" defaultWidth="20" idCommandList="MyCommandListID" priority="0x102" type="DropDownCombo">
  <Parent>... </Parent
  <CommandFlag>... </CommandFlag>
  <Strings>... </Strings>
</combo>

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.
defaultWidth	Erforderlich. Eine ganze Zahl, die eine Pixelbreite des Kombinationsfelds angibt.
idCommandList	Erforderlich. Eine ID, die dem aktuellen commmand Ziel gesendet wird, um die Liste der im Kombinationsfeld angezeigt werden soll, Elemente abzurufen. Die ID ist im selben GUID-Bereich wie das Steuerelement.
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. DropDownCombo VSPackage ist zum Ausfüllen im Inhalt für dieses Kombinationsfeld verantwortlich. Der Benutzer kann Nothing in Dropdowns dieses Textfeld eingeben. DynamicCombo VSPackage ist zum Ausfüllen im Inhalt dieses Kombinationsfelds verantwortlich. Der Benutzer kann dieses Kombinationsfeld bearbeitet und Elemente dort auch auswählen. IndexCombo Wie DynamicCombo mit der Ausnahme, dass sie löst den Index des Elements stattdessen Text aus. MRUCombo Wird von der integrierten Entwicklungsumgebung (IDE) im Namen VSPackages. Der Benutzer kann in diesem Kombinationsfeld bearbeitet werden. Die IDE speichert bis zu den letzten 16 Einträgen pro Kombinationsfeld. Wenn der Benutzer Änderungen im Kombinationsfeld auswählt, oder ein neues etwas eingeben, benachrichtigt die IDE entsprechende VSPackage.
Bedingung	Optional. Weitere Informationen finden Sie unter Bedingte Attribute für das VSCT-XML-Schema.

Untergeordnete Elemente

Parent (Übergeordnet)

Optional. Das übergeordnete Element der Schaltfläche.

CommandFlag

Erforderlich. Weitere Informationen finden Sie unter Command Flag-Element. Die gültigen CommandFlag-Werte für eine Schaltfläche lauten wie folgt:

CaseSensitive	CommandWellOnly
DefaultDisabled	DefaultInvisible
DynamicVisibility	FilterKeys
IconAndText	NoAutoComplete
NoButtonCustomize	NoCustomize
NoKeyCustomize	StretchHorizontally

Zeichenfolgen

Erforderlich. Weitere Informationen finden Sie unter Strings-Element. Das untergeordnete ButtonText-Element muss definiert werden.

Anmerkung

Optionaler Kommentar.

Übergeordnete Elemente

Element	Beschreibung
Commands-Element	Stellt die Auflistung der Befehle in der VSPackage-Symbolleiste dar.

Beispiel

<Combo guid="guidWidgetPackage" id="cmdidInsertOptions"
  defaultWidth="100" idCommandList="cmdidGetInsertOptionsList">
  <CommandFlag>DynamicVisibility</CommandFlag>
  <Strings>
    <ButtonText>Select Insert Options</ButtonText>
  </Strings>
</Combo>

<Combo guid="guidWidgetPackage" id="cmdidInsertOptions"
  priority="0x0500" type="DropDownCombo" defaultWidth="100"
  idCommandList="cmdidGetInsertOptionsList">
  <Parent guid="cmdSetGuidWidgetCommands" id="groupIDFileEdit">
  <CommandFlag>DynamicVisibility</CommandFlag>
  <Strings>
    <ButtonText>Select Insert Options</ButtonText>
  </Strings>
</Combo>

Siehe auch

Weitere Ressourcen

(Visual Studio-Befehls-Tabelle. Dateien Vsct)

Freigeben über