Élément combo

  • Article

Définit les commandes qui s’affichent dans une zone de liste modifiable. Il existe quatre types de zones de liste déroulante, comme suit : DropDownCombo, DynamicCombo, IndexCombo et MRUCombo.

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut Description
guid Obligatoire. GUID de l’identificateur de commande GUID/ID.
id Obligatoire. ID de l’identificateur de commande GUID/ID.
defaultWidth Obligatoire. Entier qui spécifie une largeur de pixel pour la zone de liste déroulante.
idCommandList Obligatoire. ID envoyé à la cible de commande active pour récupérer la liste des éléments à afficher dans la zone de liste déroulante. L’ID se trouvera dans la même étendue GUID que le contrôle.
priority facultatif. Valeur numérique qui spécifie la priorité.
type facultatif. Valeur énumérée qui spécifie le type de bouton.

Si ce n’est pas le cas, utilise Button.

DropDownCombo
VsPackage est chargé de remplir le contenu de cette zone de liste modifiable. L’utilisateur ne peut rien taper dans la zone de texte de cette liste déroulante.

DynamicCombo
VsPackage est chargé de remplir le contenu de cette zone de liste modifiable. L’utilisateur peut modifier cette liste déroulante et également sélectionner des éléments dans celui-ci.

IndexCombo
Identique à DynamicCombo, sauf qu’il déclenche l’index de l’élément plutôt que son texte.

MRUCombo
Rempli par l’environnement de développement intégré (IDE) pour le compte de VSPackage. L’utilisateur peut modifier dans cette zone de liste modifiable. L’IDE se souvient jusqu’aux 16 dernières entrées par zone de liste déroulante.

Lorsque l’utilisateur sélectionne quelque chose dans la zone de liste déroulante ou entre quelque chose de nouveau, l’IDE avertit le VSPackage approprié.
Condition facultatif. Consultez les attributs conditionnels.

Éléments enfants

Élément Description
Parent facultatif. Élément parent du bouton.
CommandFlag Obligatoire. Voir l’élément Indicateur de commande. Les valeurs CommandFlag valides pour un bouton sont les suivantes.

- Respect de la casse

- CommandWellOnly

- DefaultDisabled

- DefaultInvisible

- DynamicVisibility

- FilterKeys

- IconAndText

- NoAutoComplete

- NoButtonCustomize

- NoCustomize

- NoKeyCustomize

- StretchHorizontally
Chaînes Obligatoire. Voir l’élément Strings. L’élément ButtonText enfant doit être défini.
Annotation Commentaire facultatif.

Éléments parents

Élément Description
Élément Commands Représente la collection de commandes dans la barre d’outils VSPackage.

Exemple

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

Voir aussi