Combo-Element
Definiert Befehle, die in einem Kombinationsfeld angezeigt werden. Es gibt vier Arten von Kombinationsfeldern, wie folgt: DropDownCombo, DynamicCombo, IndexCombo und MRUCombo.
Syntax
<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. GUID des GUID/ID-Befehlsbezeichners. |
| id | Erforderlich. ID des GUID/ID-Befehlsbezeichners. |
| defaultWidth | Erforderlich. Eine ganze Zahl, die eine Pixelbreite für das Kombinationsfeld angibt. |
| idCommandList | Erforderlich. Eine ID, die an das aktive Befehlsziel gesendet wird, um die Liste der Elemente abzurufen, die im Kombinationsfeld angezeigt werden sollen. Die ID befindet sich im gleichen GUID-Bereich wie das Steuerelement. |
| priority | Optional. Ein numerischer Wert, der die Priorität angibt. |
| Typ | Optional. Ein Aufzählungswert, der den Typ der Schaltfläche angibt. Wenn nicht angegeben, verwendet "Button". DropDownCombo Das VSPackage ist für das Ausfüllen des Inhalts für dieses Kombinationsfeld verantwortlich. Der Benutzer kann nichts in das Textfeld dieser Dropdownliste eingeben. DynamicCombo Das VSPackage ist für das Ausfüllen des Inhalts dieses Kombinationsfelds verantwortlich. Der Benutzer kann diese Kombination bearbeiten und auch Elemente darin auswählen. IndexCombo Identisch mit DynamicCombo, mit der Ausnahme, dass der Index des Elements anstelle des Texts ausgelöst wird. MRUCombo Gefüllt von der integrierten Entwicklungsumgebung (Integrated Development Environment, IDE) im Auftrag von VSPackage. Der Benutzer kann in diesem Kombinationsfeld bearbeiten. Die IDE merkt sich bis zu den letzten 16 Einträgen pro Kombinationsfeld. Wenn der Benutzer etwas im Kombinationsfeld auswählt oder etwas Neues eingibt, benachrichtigt die IDE die entsprechende VSPackage. |
| Bedingung | Optional. Siehe Bedingte Attribute. |
Untergeordnete Elemente
| Element | Beschreibung |
|---|---|
| Parent | Optional. Das übergeordnete Element der Schaltfläche. |
| CommandFlag | Erforderlich. Siehe Befehlskennzeichnungselement. Die gültigen CommandFlag-Werte für eine Schaltfläche sind wie folgt. -Casesensitive - CommandWellOnly - DefaultDisabled - DefaultInvisible - Dynamische Sichtbarkeit - FilterKeys - IconAndText - NoAutoComplete - NoButtonCustomize - NoCustomize - NoKeyCustomize - StretchHorizontally |
| Zeichenfolgen | Erforderlich. Siehe Strings-Element. Das untergeordnete ButtonText-Element muss definiert werden. |
| Anmerkung | Optionaler Kommentar. |
Übergeordnete Elemente
| Element | Beschreibung |
|---|---|
| Commands-Element | Stellt die Auflistung von Befehlen auf 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>