Stili di controllo e pulsante della barra degli strumenti

Gli stili di finestra seguenti sono specifici delle barre degli strumenti. Vengono combinati con altri stili di finestra quando viene creata la barra degli strumenti.

Nota Per Common Controls versione 6.00, se viene usato uno stile visivo con la barra degli strumenti, i pulsanti sono sempre trasparenti indipendentemente dall'impostazione dello stile. In caso contrario, il comportamento di trasparenza è normale come indicato dall'uso dello stile TBSTYLE_FLAT o TBSTYLE_TRANSPARENT.

Nota

Comctl32.dll versione 6 non è ridistribuibile, ma è incluso in Windows. Per usare Comctl32.dll versione 6, specificarlo in un manifesto. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.

Costante Descrizione
TBSTYLE_ALTDRAG
Consente agli utenti di modificare la posizione di un pulsante della barra degli strumenti trascinandolo mentre tiene premuto il tasto ALT. Se questo stile non è specificato, l'utente deve tenere premuto il tasto MAIUSC durante il trascinamento di un pulsante. Si noti che lo stile CCS_ADJUSTABLE deve essere specificato per abilitare i pulsanti della barra degli strumenti da trascinare.
TBSTYLE_CUSTOMERASE
Versione 4.70. Genera NM_CUSTOMDRAW codici di notifica quando la barra degli strumenti elabora i messaggi WM_ERASEBKGND .
TBSTYLE_FLAT
Versione 4.70. Crea una barra degli strumenti flat. In una barra degli strumenti flat, sia la barra degli strumenti che i pulsanti sono trasparenti e il rilevamento frequente è abilitato. Il testo del pulsante viene visualizzato sotto le bitmap del pulsante. Per evitare problemi di ripainting, questo stile deve essere impostato prima che il controllo della barra degli strumenti diventi visibile.
TBSTYLE_LIST
Versione 4.70. Crea una barra degli strumenti flat con il testo del pulsante a destra della bitmap. In caso contrario, questo stile è identico a TBSTYLE_FLAT. Per evitare problemi di ripainting, questo stile deve essere impostato prima che il controllo della barra degli strumenti diventi visibile.
TBSTYLE_REGISTERDROP
Versione 4.71. Genera TBN_GETOBJECT codici di notifica per richiedere oggetti di destinazione quando il cursore passa sui pulsanti della barra degli strumenti.
TBSTYLE_TOOLTIPS
Crea un controllo della descrizione comando che un'applicazione può usare per visualizzare testo descrittivo per i pulsanti nella barra degli strumenti.
TBSTYLE_TRANSPARENT
Versione 4.71. Crea una barra degli strumenti trasparente. In una barra degli strumenti trasparente la barra degli strumenti è trasparente, ma i pulsanti non sono. Il testo del pulsante viene visualizzato sotto le bitmap del pulsante. Per evitare problemi di ripainting, questo stile deve essere impostato prima che il controllo della barra degli strumenti diventi visibile.
TBSTYLE_WRAPABLE
Crea una barra degli strumenti che può avere più righe di pulsanti. I pulsanti della barra degli strumenti possono "eseguire il wrapping" alla riga successiva quando la barra degli strumenti diventa troppo stretta per includere tutti i pulsanti nella stessa riga. Quando viene eseguito il wrapping della barra degli strumenti, l'interruzione si verificherà sul separatore più a destra o sul pulsante più a destra se non sono presenti separatori sulla barra. Questo stile deve essere impostato per visualizzare un controllo della barra degli strumenti verticale quando la barra degli strumenti fa parte di un controllo della barra verticale. Questo stile non può essere combinato con CCS_VERT.

Nota: Un pulsante della barra degli strumenti può avere una combinazione degli stili seguenti. Per specificare uno stile di pulsante, impostare i flag appropriati nel membro fsStyle della struttura TBBUTTON del pulsante. Non tutti gli stili possono essere combinati.

Per Shell versione 4.72 e versioni precedenti, entrambi i flag di stile finestra e pulsante hanno il modulo TBSTYLE_XXX. Se si compila un'applicazione con la versione 4.72 o precedente di Commctrl.h, è necessario usare i flag di stile del pulsante TBSTYLE_XXX. Per la versione 5.80 e successiva, tutti gli stili di pulsante hanno il modulo BTNS_XXX. Tutti i valori TBSTYLE_XXX hanno valori equivalenti BTNS_XXX, con lo stesso significato e valore numerico. Per praticità, entrambe le forme vengono fornite nella tabella seguente.

Costante Descrizione
BTNS_AUTOSIZE
Versione 5.80. Specifica che il controllo della barra degli strumenti non deve assegnare la larghezza standard al pulsante. La larghezza del pulsante verrà invece calcolata in base alla larghezza del testo e all'immagine del pulsante. Usare il flag di stile equivalente, TBSTYLE_AUTOSIZE, per la versione 4.72 e versioni precedenti.
BTNS_BUTTON
Versione 5.80. Crea un pulsante standard. Usare il flag di stile equivalente, TBSTYLE_BUTTON, per la versione 4.72 e versioni precedenti. Questo flag è definito come 0 e deve essere usato per firmare che non sono impostati altri flag.
BTNS_CHECK
Versione 5.80. Crea un pulsante push a doppio stato che attiva l'interruttore tra gli stati premuti e non compressi ogni volta che l'utente lo fa clic. Il pulsante ha un colore di sfondo diverso quando si trova nello stato premuto. Usare il flag di stile equivalente, TBSTYLE_CHECK, per la versione 4.72 e versioni precedenti.
BTNS_CHECKGROUP
Versione 5.80. Crea un pulsante che rimane premuto fino a quando non viene premuto un altro pulsante nel gruppo, simile ai pulsanti di opzione (noti anche come pulsanti di opzione). Equivale a combinare BTNS_CHECK e BTNS_GROUP. Usare il flag di stile equivalente, TBSTYLE_CHECKGROUP, per la versione 4.72 e versioni precedenti.
BTNS_DROPDOWN
Versione 5.80. Crea un pulsante a discesa che può visualizzare un elenco quando viene fatto clic sul pulsante. Anziché il messaggio WM_COMMAND usato per i pulsanti normali, i pulsanti a discesa inviano un codice di notifica TBN_DROPDOWN . Un'applicazione può quindi avere il gestore di notifica che visualizza un elenco di opzioni. Usare il flag di stile equivalente, TBSTYLE_DROPDOWN, per la versione 4.72 e versioni precedenti.
Se la barra degli strumenti ha lo stile esteso TBSTYLE_EX_DRAWDDARROWS , i pulsanti a discesa avranno una freccia a discesa visualizzata in una sezione separata a destra. Se si fa clic sulla freccia, verrà inviato un codice di notifica TBN_DROPDOWN. Se viene fatto clic sul pulsante associato, verrà inviato un messaggio di WM_COMMAND.
BTNS_GROUP
Versione 5.80. Se combinato con BTNS_CHECK, crea un pulsante che rimane premuto fino a quando non viene premuto un altro pulsante nel gruppo. Usare il flag di stile equivalente, TBSTYLE_GROUP, per la versione 4.72 e versioni precedenti.
BTNS_NOPREFIX
Versione 5.80. Specifica che il testo del pulsante non avrà un prefisso acceleratore associato. Usare il flag di stile equivalente, TBSTYLE_NOPREFIX, per la versione 4.72 e versioni precedenti.
BTNS_SEP
Versione 5.80. Crea un separatore, fornendo un piccolo divario tra i gruppi di pulsanti. Un pulsante con questo stile non riceve l'input utente. Usare il flag di stile equivalente, TBSTYLE_SEP, per la versione 4.72 e versioni precedenti.
BTNS_SHOWTEXT
Versione 5.81. Specifica che il testo del pulsante deve essere visualizzato. Tutti i pulsanti possono avere testo, ma solo i pulsanti con lo stile del pulsante BTNS_SHOWTEXT lo visualizzeranno. Questo stile del pulsante deve essere usato con lo stile TBSTYLE_LIST e lo stile esteso TBSTYLE_EX_MIXEDBUTTONS . Se si imposta il testo per i pulsanti che non hanno lo stile BTNS_SHOWTEXT, il controllo della barra degli strumenti lo visualizzerà automaticamente come descrizione comando quando il cursore passa il mouse sul pulsante. Questa funzionalità consente all'applicazione di evitare di gestire il TBN_GETINFOTIP o TTN_GETDISPINFO codice di notifica per la barra degli strumenti.
BTNS_WHOLEDROPDOWN
Versione 5.80. Specifica che il pulsante avrà una freccia a discesa, ma non come sezione separata. I pulsanti con questo stile si comportano allo stesso modo, indipendentemente dal fatto che lo stile esteso TBSTYLE_EX_DRAWDDARROWS sia impostato.
TBSTYLE_AUTOSIZE
Equivalente a BTNS_AUTOSIZE. Usare TBSTYLE_AUTOSIZE per la versione 4.72 e versioni precedenti.
TBSTYLE_BUTTON
Equivalente a BTNS_BUTTON. Usare TBSTYLE_BUTTON per la versione 4.72 e versioni precedenti.
TBSTYLE_CHECK
Equivalente a BTNS_CHECK. Usare TBSTYLE_CHECK per la versione 4.72 e versioni precedenti.
TBSTYLE_CHECKGROUP
Equivalente a BTNS_CHECKGROUP. Usare TBSTYLE_CHECKGROUP per la versione 4.72 e versioni precedenti.
TBSTYLE_DROPDOWN
Equivalente a BTNS_DROPDOWN. Usare TBSTYLE_DROPDOWN per la versione 4.72 e versioni precedenti.
TBSTYLE_GROUP
Equivalente a BTNS_GROUP. Usare TBSTYLE_GROUP per la versione 4.72 e versioni precedenti.
TBSTYLE_NOPREFIX
Equivalente a BTNS_NOPREFIX. Usare TBSTYLE_NOPREFIX per la versione 4.72 e versioni precedenti.
TBSTYLE_SEP
Equivalente a BTNS_SEP. Usare TBSTYLE_SEP per la versione 4.72 e versioni precedenti.

Requisiti

Requisito Valore
Intestazione
CommCtrl.h