Элемент Combo
Определяет команды, которые отображаются в поле со списком. Существует четыре типа полей со списком, как показано ниже: DropDownCombo, DynamicCombo, IndexCombo и MRUCombo.
Синтаксис
<combo guid="guidMyCommandSet" id="MyCommand" defaultWidth="20" idCommandList="MyCommandListID" priority="0x102" type="DropDownCombo">
<Parent>... </Parent
<CommandFlag>... </CommandFlag>
<Strings>... </Strings>
</combo>
Элементы и атрибуты
В следующих разделах описаны атрибуты, дочерние и родительские элементы.
Атрибуты
Атрибут | Description |
---|---|
guid | Обязательно. GUID идентификатора команды GUID/ID. |
id | Обязательно. Идентификатор идентификатора команды GUID/ID. |
defaultWidth | Обязательно. Целое число, указывающее ширину пикселя для поля со списком. |
idCommandList | Обязательно. Идентификатор, который отправляется в активный целевой объект команды, чтобы получить список элементов, отображаемых в поле со списком. Идентификатор будет находиться в том же идентификаторе GUID область, что и элемент управления. |
priority | Необязательно. Числовое значение, указывающее приоритет. |
type | Необязательно. Перечисленное значение, указывающее тип кнопки. Если это не задано, использует кнопку. DropDownCombo VSPackage отвечает за заполнение содержимого этого поля со списком. Пользователь не может вводить ничего в текстовом поле этого раскрывающегося списка. DynamicCombo VSPackage отвечает за заполнение содержимого этого поля со списком. Пользователь может изменить этот combo, а также выбрать элементы в нем. IndexCombo То же, что и DynamicCombo, за исключением того, что он вызывает индекс элемента, а не его текст. MRUCombo Заполнен интегрированной средой разработки (IDE) от имени VSPackage. Пользователь может изменить этот флажок со списком. Интегрированная среда разработки запоминает до последних 16 записей на поле со списком. Когда пользователь выбирает что-то в поле со списком или вводит что-то новое, интегрированная среда разработки уведомляет соответствующий VSPackage. |
Condition | Необязательно. См . условные атрибуты. |
Дочерние элементы
Элемент | Description |
---|---|
Parent | Необязательно. Родительский элемент кнопки. |
CommandFlag | Обязательно. См . элемент флага command. Допустимые значения CommandFlag для кнопки приведены ниже. — CaseSensitive — CommandWellOnly — DefaultDisabled — DefaultInvisible — DynamicVisibility — FilterKeys - IconAndText - NoAutoComplete - NoButtonCustomize - NoCustomize - NoKeyCustomize - StretchHorizontally |
Строки | Обязательно. См . элемент Strings. Необходимо определить дочерний элемент ButtonText. |
Номер | Необязательный комментарий. |
Родительские элементы
Элемент | Description |
---|---|
Элемент Commands | Представляет коллекцию команд на панели инструментов VSPackage. |
Пример
<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>