Compartilhar via


Elemento de combinação

Define comandos que aparecem em uma caixa de combinação. Existem quatro tipos de caixas de combinação, da seguinte forma: DropDownCombo, DynamicCombo, IndexCombo e MRUCombo.

Syntax

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo Descrição
guid Obrigatório. GUID do identificador de comando GUID/ID.
ID Obrigatório. ID do identificador de comando GUID/ID.
defaultWidth Obrigatório. Um inteiro que especifica uma largura de pixel para a caixa de combinação.
idCommandList Obrigatório. Uma ID enviada ao destino do comando ativo para recuperar a lista de itens a serem exibidos na caixa de combinação. O ID estará no mesmo escopo GUID que o controle.
priority Opcional. Um valor numérico que especifica a prioridade.
tipo Opcional. Um valor enumerado que especifica o tipo de botão.

Se não for fornecido, usa Button.

DropDownCombo
O VSPackage é responsável pelo preenchimento do conteúdo desta caixa de combinação. O usuário não pode digitar nada na caixa de texto desta lista suspensa.

Combo Dinâmico
O VSPackage é responsável pelo preenchimento do conteúdo desta caixa de combinação. O usuário pode editar esse combo e também selecionar itens nele.

IndexCombo
O mesmo que DynamicCombo, exceto que ele aumenta o índice do item em vez de seu texto.

MRUCombo
Preenchido pelo ambiente de desenvolvimento integrado (IDE) em nome do VSPackage. O usuário pode editar nesta caixa de combinação. O IDE lembra até as últimas 16 entradas por caixa de combinação.

Quando o usuário seleciona algo na caixa de combinação ou insere algo novo, o IDE notifica o VSPackage apropriado.
Condição Opcional. Consulte Atributos condicionais.

Elementos filho

Elemento Descrição
Pai Opcional. O elemento pai do botão.
CommandFlag Obrigatório. Consulte Elemento sinalizador de comando. Os valores CommandFlag válidos para um Button são os seguintes.

- Sensível a maiúsculas e minúsculas

- CommandWellOnly

- DefaultDisabled

- DefaultInvisible

- Visibilidade dinâmica

- FilterKeys

- IconAndText

- NoAutoComplete

- NoButtonCustomize

- NãoPersonalizar

- NoKeyCustomize

- Alongamento horizontal
Cadeias de caracteres Obrigatório. Consulte Elemento Strings. O elemento filho ButtonText deve ser definido.
Anotação Comentário opcional.

Elementos pai

Elemento Descrição
Elemento Commands Representa a coleção de comandos na barra de ferramentas VSPackage.

Exemplo

<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>

Confira também