Combo – element
Definuje příkazy, které se zobrazí v poli se seznamem. Existují čtyři druhy polí se seznamem: DropDownCombo, DynamicCombo, IndexCombo a MRUCombo.
Syntaxe
<combo guid="guidMyCommandSet" id="MyCommand" defaultWidth="20" idCommandList="MyCommandListID" priority="0x102" type="DropDownCombo">
<Parent>... </Parent
<CommandFlag>... </CommandFlag>
<Strings>... </Strings>
</combo>
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. |
| defaultWidth | Povinný: Celé číslo, které určuje šířku pixelů pro pole se seznamem. |
| IdCommandList | Povinný: ID odeslané do aktivního cíle příkazu pro načtení seznamu položek, které se mají zobrazit v poli se seznamem. ID bude ve stejném oboru GUID jako ovládací prvek. |
| 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. DropDownCombo Balíček VSPackage zodpovídá za vyplnění obsahu tohoto pole se seznamem. Uživatel nemůže do textového pole tohoto rozevíracího seznamu zadat nic. DynamicCombo Balíček VSPackage zodpovídá za vyplnění obsahu tohoto pole se seznamem. Uživatel může toto pole se seznamem upravit a také vybrat položky v něm. IndexCombo Totéž jako DynamicCombo s tím rozdílem, že vyvolá index položky místo jeho textu. MRUCombo Vyplněné integrovaným vývojovými prostředími (IDE) jménem balíčku VSPackage. Uživatel může upravit v tomto poli se seznamem. Integrované vývojové prostředí si pamatuje až posledních 16 položek na pole se seznamem. Když uživatel vybere něco v poli se seznamem nebo zadá něco nového, integrované vývojové prostředí oznámí příslušnému balíčku VSPackage. |
| Podmínka | Nepovinné. Viz Podmíněné atributy. |
Podřízené prvky
| Element (Prvek) | Popis |
|---|---|
| Parent | Nepovinné. Nadřazený prvek tlačítka. |
| CommandFlag | Povinný: Viz Element příznaku příkazu. Platné hodnoty CommandFlag pro tlačítko jsou následující. - Nerozlišuje velká a malá písmena - CommandWellOnly – DefaultDisabled – DefaultInvisible - DynamicVisibility - FilterKeys - IconAndText - NoAutoComplete - NoButtonCustomize - NoCustomize - NoKeyCustomize - RoztaženíHorizontálně |
| Řetězce | Povinný: Viz Element Strings. Podřízený element ButtonText musí být definován. |
| Poznámka | Volitelný komentář. |
Nadřazené prvky
| Element (Prvek) | Popis |
|---|---|
| Commands – element | Představuje kolekci příkazů na panelu nástrojů VSPackage. |
Příklad
<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>