Elemento de combinação

Artigo
01/12/2024

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

Arquivos de tabela de comando (.vsct) do Visual Studio

Compartilhar via