Elemento combo

Articolo
01/12/2024

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

File della tabella dei comandi di Visual Studio (con estensione vsct)

Condividi tramite