Elemento combinado

  • Artículo

Define los comandos que aparecen en un cuadro combinado. Hay cuatro tipos de cuadros combinados, como se indica a continuación: DropDownCombo, DynamicCombo, IndexCombo y MRUCombo.

Sintaxis

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

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo Descripción
guid Necesario. GUID del identificador de comando GUID/ID.
id Necesario. Identificador del identificador de comando GUID/ID.
defaultWidth Necesario. Entero que especifica un ancho de píxel para el cuadro combinado.
idCommandList Necesario. Identificador que se envía al destino de comando activo para recuperar la lista de elementos que se van a mostrar en el cuadro combinado. El identificador estará en el mismo ámbito GUID que el control.
priority Opcional. Valor numérico que especifica la prioridad.
type Opcional. Valor enumerado que especifica el tipo de botón.

Si no se da, usa Button.

DropDownCombo
VSPackage es responsable de rellenar el contenido de este cuadro combinado. El usuario no puede escribir nada en el cuadro de texto de esta lista desplegable.

DynamicCombo
VSPackage es responsable de rellenar el contenido de este cuadro combinado. El usuario puede editar este combo y seleccionar también elementos en él.

IndexCombo
Igual que DynamicCombo, salvo que genera el índice del elemento en lugar de su texto.

MRUCombo
Rellenado por el entorno de desarrollo integrado (IDE) en nombre de VSPackage. El usuario puede editar en este cuadro combinado. El IDE recuerda hasta las últimas 16 entradas por cuadro combinado.

Cuando el usuario selecciona algo en el cuadro combinado o escribe algo nuevo, el IDE notifica al VSPackage adecuado.
Condición Opcional. Consulte Atributos condicionales.

Elementos secundarios

Elemento Descripción
Parent Opcional. Elemento primario del botón.
CommandFlag Necesario. Vea Elemento de marca de comando. Los valores de CommandFlag válidos para un botón son los siguientes.

- CaseSensitive

- CommandWellOnly

- DefaultDisabled

- DefaultInvisible

- DynamicVisibility

-Filterkeys

- IconAndText

- NoAutoComplete

- NoButtonCustomize

- NoCustomize

- NoKeyCustomize

- StretchHorizontally
Cadenas Necesario. Consulte el elemento Strings. Se debe definir el elemento ButtonText secundario.
Annotation Comentario opcional.

Elementos primarios

Elemento Descripción
Elemento Commands Representa la colección de comandos de la barra de herramientas de VSPackage.

Ejemplo

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

Consulte también