Condividi tramite


Elemento combo

Definisce i comandi visualizzati in una casella combinata. Esistono quattro tipi di caselle combinate, come indicato di seguito: DropDownCombo, DynamicCombo, IndexCombo e MRUCombo.

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
guid Obbligatorio. GUID dell'identificatore di comando GUID/ID.
ID Obbligatorio. ID dell'identificatore di comando GUID/ID.
defaultWidth Obbligatorio. Intero che specifica una larghezza in pixel per la casella combinata.
idCommandList Obbligatorio. ID inviato alla destinazione del comando attiva per recuperare l'elenco di elementi da visualizzare nella casella combinata. L'ID si troverà nello stesso ambito GUID del controllo.
priority Facoltativo. Valore numerico che specifica la priorità.
type Facoltativo. Valore enumerato che specifica il tipo di pulsante.

Se non specificato, usa Button.

DropDownCombo
Il VSPackage è responsabile della compilazione del contenuto per questa casella combinata. L'utente non può digitare nulla nella casella di testo di questo elenco a discesa.

DynamicCombo
Il VSPackage è responsabile della compilazione del contenuto di questa casella combinata. L'utente può modificare questa combinazione e selezionare anche gli elementi in esso contenuti.

IndexCombo
Uguale a DynamicCombo, ad eccezione del fatto che genera l'indice dell'elemento anziché il relativo testo.

MRUCombo
Compilato dall'ambiente di sviluppo integrato (IDE) per conto del VSPackage. L'utente può modificare in questa casella combinata. L'IDE memorizza fino alle ultime 16 voci per casella combinata.

Quando l'utente seleziona qualcosa nella casella combinata o immette qualcosa di nuovo, l'IDE invia una notifica al pacchetto VSPackage appropriato.
Condizione Facoltativo. Vedere Attributi condizionali.

Elementi figlio

Elemento Descrizione
Parent Facoltativo. Elemento padre del pulsante.
CommandFlag Obbligatorio. Vedere Elemento flag command. I valori CommandFlag validi per un controllo Button sono i seguenti.

- CaseSensitive

- CommandWellOnly

- DefaultDisabled

- DefaultInvisible

- DynamicVisibility

- FilterKeys

- IconAndText

- NoAutoComplete

- NoButtonCustomize

- NoCustomize

- NoKeyCustomize

- StretchHorizontally
Stringhe Obbligatorio. Vedere Elemento Strings. L'elemento ButtonText figlio deve essere definito.
Annotazione Commento facoltativo.

Elementi padre

Elemento Descrizione
Elemento Commands Rappresenta la raccolta di comandi sulla barra degli strumenti VSPackage.

Esempio

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

Vedi anche