Condividi tramite

Barra degli strumenti

  • Articolo

Questa sezione contiene informazioni sugli elementi di programmazione usati con i controlli della barra degli strumenti.

Panoramiche

Argomento Contenuto
Informazioni sui controlli della barra degli strumenti Una barra degli strumenti è un controllo che contiene uno o più pulsanti. Ogni pulsante, quando si fa clic da un utente, invia un messaggio di comando alla finestra padre. In genere, i pulsanti di una barra degli strumenti corrispondono agli elementi del menu dell'applicazione, fornendo un modo aggiuntivo e più diretto per consentire all'utente di accedere ai comandi di un'applicazione.
uso di controlli barra degli strumenti Questo argomento contiene i dettagli di implementazione e il codice di esempio per l'uso dei controlli della barra degli strumenti nelle applicazioni.

Funzioni

Argomento Contenuto
CreateMappedBitmap Crea una bitmap da utilizzare in una barra degli strumenti.
CreateToolbarEx Crea una finestra della barra degli strumenti e aggiunge i pulsanti specificati alla barra degli strumenti. Nota: Questa funzione è deprecata, perché non supporta tutte le funzionalità delle barre degli strumenti. In alternativa, usare CreateWindowEx. Per esempi, vedere uso dei controlli della barra degli strumenti.

Messaggi

Argomento Contenuto
TB_ADDBITMAP Aggiunge una o più immagini all'elenco di immagini dei pulsanti disponibili per una barra degli strumenti.
TB_ADDBUTTONS Aggiunge uno o più pulsanti a una barra degli strumenti.
TB_ADDSTRING Aggiunge una nuova stringa al pool di stringhe della barra degli strumenti.
TB_AUTOSIZE Determina il ridimensionamento di una barra degli strumenti.
TB_BUTTONCOUNT Recupera un conteggio dei pulsanti attualmente presenti nella barra degli strumenti.
TB_BUTTONSTRUCTSIZE Specifica le dimensioni della strutturaTBBUTTON.
TB_CHANGEBITMAP Modifica la bitmap per un pulsante in una barra degli strumenti.
TB_CHECKBUTTON Controlla o deseleziona un determinato pulsante in una barra degli strumenti.
TB_COMMANDTOINDEX Recupera l'indice in base zero per il pulsante associato all'identificatore di comando specificato.
TB_CUSTOMIZE Visualizza la finestra di dialogo Personalizza barra degli strumenti .
TB_DELETEBUTTON Elimina un pulsante dalla barra degli strumenti.
TB_ENABLEBUTTON Abilita o disabilita il pulsante specificato in una barra degli strumenti.
TB_GETANCHORHIGHLIGHT Recupera l'impostazione di evidenziazione dell'ancoraggio per una barra degli strumenti.
TB_GETBITMAP Recupera l'indice della bitmap associata a un pulsante in una barra degli strumenti.
TB_GETBITMAPFLAGS Recupera i flag che descrivono il tipo di bitmap da utilizzare.
TB_GETBUTTON Recupera informazioni sul pulsante specificato in una barra degli strumenti.
TB_GETBUTTONINFO Recupera informazioni estese per un pulsante in una barra degli strumenti.
TB_GETBUTTONSIZE Recupera la larghezza e l'altezza correnti dei pulsanti della barra degli strumenti, in pixel.
TB_GETBUTTONTEXT Recupera il testo visualizzato di un pulsante su una barra degli strumenti.
TB_GETCOLORSCHEME Recupera le informazioni sulla combinazione di colori dal controllo barra degli strumenti.
TB_GETDISABLEDIMAGELIST Recupera l'elenco di immagini utilizzato da un controllo barra degli strumenti per visualizzare pulsanti inattivi.
TB_GETEXTENDEDSTYLE Recupera gli stili estesi per un controllo barra degli strumenti.
TB_GETHOTIMAGELIST Recupera l'elenco di immagini utilizzato da un controllo barra degli strumenti per visualizzare i pulsanti di scelta rapida.
TB_GETHOTITEM Recupera l'indice dell'elemento attivo in una barra degli strumenti.
TB_GETIDEALSIZE Ottiene le dimensioni ideali della barra degli strumenti.
TB_GETIMAGELIST Recupera l'elenco di immagini utilizzato da un controllo barra degli strumenti per visualizzare i pulsanti nello stato predefinito. Un controllo barra degli strumenti usa questo elenco di immagini per visualizzare i pulsanti quando non sono attivati o disabilitati.
TB_GETIMAGELISTCOUNT Ottiene il numero di elenchi di immagini associati alla barra degli strumenti.
TB_GETINSERTMARK Recupera il segno di inserimento corrente per la barra degli strumenti.
TB_GETINSERTMARKCOLOR Recupera il colore utilizzato per disegnare il segno di inserimento per la barra degli strumenti.
TB_GETITEMDROPDOWNRECT Ottiene il rettangolo di delimitazione della finestra a discesa per un elemento della barra degli strumenti con stile BTNS_DROPDOWN.
TB_GETITEMRECT Recupera il rettangolo di delimitazione di un pulsante in una barra degli strumenti.
TB_GETMAXSIZE Recupera le dimensioni totali di tutti i pulsanti e i separatori visibili nella barra degli strumenti.
TB_GETMETRICS Recupera le metriche di un controllo barra degli strumenti.
TB_GETOBJECT Recupera iIDropTargetper un controllo barra degli strumenti.
TB_GETPADDING Recupera la spaziatura interna per un controllo barra degli strumenti.
TB_GETPRESSEDIMAGELIST Ottiene l'elenco di immagini utilizzato da un controllo barra degli strumenti per visualizzare i pulsanti in uno stato premuto.
TB_GETRECT Recupera il rettangolo di delimitazione per un pulsante della barra degli strumenti specificato.
TB_GETROWS Recupera il numero di righe di pulsanti in una barra degli strumenti con lo stile TBSTYLE_WRAPABLE.
TB_GETSTATE Recupera informazioni sullo stato del pulsante specificato in una barra degli strumenti, ad esempio se è abilitato, premuto o selezionato.
TB_GETSTRING Recupera una stringa dal pool di stringhe di una barra degli strumenti.
TB_GETSTYLE Recupera gli stili attualmente in uso per un controllo barra degli strumenti.
TB_GETTEXTROWS Recupera il numero massimo di righe di testo che possono essere visualizzate su un pulsante della barra degli strumenti.
TB_GETTOOLTIPS Recupera l'handle nel controllo descrizione comando, se presente, associato alla barra degli strumenti.
TB_GETUNICODEFORMAT Recupera il flag di formato carattere Unicode per il controllo .
TB_HASACCELERATOR destinato all'uso interno; non consigliato per l'uso nelle applicazioni.
Recupera un conteggio dei pulsanti della barra degli strumenti con il carattere di scelta rapida specificato.
TB_HIDEBUTTON Nasconde o mostra il pulsante specificato in una barra degli strumenti.
TB_HITTEST Determina dove si trova un punto in un controllo barra degli strumenti.
TB_INDETERMINATE Imposta o cancella lo stato indeterminato del pulsante specificato in una barra degli strumenti.
TB_INSERTBUTTON Inserisce un pulsante in una barra degli strumenti.
TB_INSERTMARKHITTEST Recupera le informazioni sul contrassegno di inserimento per un punto in una barra degli strumenti.
TB_ISBUTTONCHECKED Determina se il pulsante specificato in una barra degli strumenti è selezionato.
TB_ISBUTTONENABLED Determina se il pulsante specificato in una barra degli strumenti è abilitato.
TB_ISBUTTONHIDDEN Determina se il pulsante specificato in una barra degli strumenti è nascosto.
TB_ISBUTTONHIGHLIGHTED Controlla lo stato di evidenziazione di un pulsante della barra degli strumenti.
TB_ISBUTTONINDETERMINATE Determina se il pulsante specificato in una barra degli strumenti è indeterminato.
TB_ISBUTTONPRESSED Determina se viene premuto il pulsante specificato in una barra degli strumenti.
TB_LOADIMAGES Carica le immagini dei pulsanti definite dal sistema nell'elenco di immagini di un controllo della barra degli strumenti.
TB_MAPACCELERATOR Determina l'ID del pulsante che corrisponde al carattere di scelta rapida specificato.
TB_MARKBUTTON Imposta lo stato di evidenziazione di un determinato pulsante in un controllo barra degli strumenti.
TB_MOVEBUTTON Sposta un pulsante da un indice a un altro.
TB_PRESSBUTTON Preme o rilascia il pulsante specificato in una barra degli strumenti.
TB_REPLACEBITMAP Sostituisce una bitmap esistente con una nuova bitmap.
TB_SAVERESTORE Inviare questo messaggio per avviare il salvataggio o il ripristino di uno stato della barra degli strumenti.
TB_SETANCHORHIGHLIGHT Imposta l'impostazione di evidenziazione dell'ancoraggio per una barra degli strumenti.
TB_SETBITMAPSIZE Imposta le dimensioni delle immagini bitmap da aggiungere a una barra degli strumenti.
TB_SETBOUNDINGSIZE destinato all'uso interno; non consigliato per l'uso nelle applicazioni.
Imposta le dimensioni del delimitazione per un controllo barra degli strumenti a più colonne.
TB_SETBUTTONINFO Imposta le informazioni per un pulsante esistente in una barra degli strumenti.
TB_SETBUTTONSIZE Imposta le dimensioni dei pulsanti su una barra degli strumenti.
TB_SETBUTTONWIDTH Imposta la larghezza minima e massima dei pulsanti nel controllo barra degli strumenti.
TB_SETCMDID Imposta l'identificatore del comando di un pulsante della barra degli strumenti.
TB_SETCOLORSCHEME Imposta le informazioni sulla combinazione di colori per il controllo barra degli strumenti.
TB_SETDISABLEDIMAGELIST Imposta l'elenco di immagini che verrà utilizzato dal controllo barra degli strumenti per visualizzare i pulsanti disabilitati.
TB_SETDRAWTEXTFLAGS Imposta i flag di disegno di testo per la barra degli strumenti.
TB_SETEXTENDEDSTYLE Imposta gli stili estesi per un controllo barra degli strumenti.
TB_SETHOTIMAGELIST Imposta l'elenco di immagini che verrà utilizzato dal controllo barra degli strumenti per visualizzare i pulsanti di scelta rapida.
TB_SETHOTITEM Imposta l'elemento attivo in una barra degli strumenti.
TB_SETHOTITEM2 Imposta l'elemento attivo in una barra degli strumenti.
TB_SETIMAGELIST Imposta l'elenco di immagini utilizzato dalla barra degli strumenti per visualizzare i pulsanti nello stato predefinito.
TB_SETINDENT Imposta il rientro per il primo pulsante in un controllo barra degli strumenti.
TB_SETINSERTMARK Imposta il segno di inserimento corrente per la barra degli strumenti.
TB_SETINSERTMARKCOLOR Imposta il colore utilizzato per disegnare il segno di inserimento per la barra degli strumenti.
TB_SETLISTGAP Imposta la distanza tra i pulsanti della barra degli strumenti su una barra degli strumenti specifica.
TB_SETMAXTEXTROWS Imposta il numero massimo di righe di testo visualizzate su un pulsante della barra degli strumenti.
TB_SETMETRICS Imposta le metriche di un controllo barra degli strumenti.
TB_SETPADDING Imposta la spaziatura interna per un controllo barra degli strumenti.
TB_SETPARENT Imposta la finestra su cui il controllo della barra degli strumenti invia codici di notifica.
TB_SETPRESSEDIMAGELIST Imposta l'elenco di immagini utilizzato dalla barra degli strumenti per visualizzare i pulsanti in uno stato premuto.
TB_SETROWS Imposta il numero di righe di pulsanti in una barra degli strumenti.
TB_SETSTATE Imposta lo stato per il pulsante specificato in una barra degli strumenti.
TB_SETSTYLE Imposta lo stile per un controllo barra degli strumenti.
TB_SETTOOLTIPS Associa un controllo descrizione comando a una barra degli strumenti.
TB_SETUNICODEFORMAT Imposta il flag di formato carattere Unicode per il controllo . Questo messaggio consente di modificare il set di caratteri utilizzato dal controllo in fase di esecuzione anziché dover ricreare il controllo.
TB_SETWINDOWTHEME Imposta lo stile di visualizzazione di un controllo barra degli strumenti.
TB_TRANSLATEACCELERATOR Passa un messaggio da tastiera alla barra degli strumenti.

Notifiche

Argomento Contenuto
NM_CHAR (barra degli strumenti) Inviato dalla barra degli strumenti quando riceve un messaggio di WM_CHAR. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
NM_CLICK (barra degli strumenti) Inviato da un controllo barra degli strumenti quando l'utente fa clic su un elemento con il pulsante sinistro del mouse. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
NM_CUSTOMDRAW (barra degli strumenti) Inviato dalla barra degli strumenti per notificare alla finestra padre le operazioni di disegno. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
NM_DBLCLK (barra degli strumenti) Notifica alla finestra padre di un controllo barra degli strumenti che l'utente ha fatto doppio clic sul pulsante sinistro del mouse all'interno del controllo. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
NM_KEYDOWN (barra degli strumenti) Inviato da un controllo quando il controllo ha lo stato attivo della tastiera e l'utente preme un tasto. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
NM_LDOWN Notifica alla finestra padre di una barra degli strumenti che il pulsante sinistro del mouse è stato premuto. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
NM_RCLICK (barra degli strumenti) Inviato da un controllo barra degli strumenti quando l'utente fa clic sulla barra degli strumenti con il pulsante destro del mouse. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
NM_RDBLCLK (barra degli strumenti) Notifica alla finestra padre di un controllo che l'utente ha fatto doppio clic sul pulsante destro del mouse all'interno del controllo. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
NM_RELEASEDCAPTURE (barra degli strumenti) Notifica alla finestra padre di un controllo della barra degli strumenti che il controllo sta rilasciando l'acquisizione del mouse. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
NM_TOOLTIPSCREATED (barra degli strumenti) Notifica alla finestra padre di una barra degli strumenti che la barra degli strumenti ha creato un controllo descrizione comando. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_BEGINADJUST Notifica alla finestra padre di una barra degli strumenti che l'utente ha iniziato a personalizzare una barra degli strumenti. Questo codice di messaggio viene inviato sotto forma di messaggio WM_NOTIFY.
TBN_BEGINDRAG Notifica alla finestra padre di una barra degli strumenti che l'utente ha iniziato a trascinare un pulsante in una barra degli strumenti. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_CUSTHELP Notifica alla finestra padre di una barra degli strumenti che l'utente ha scelto il pulsante ? nella finestra di dialogo Personalizza barra degli strumenti. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_DELETINGBUTTON Inviato da un controllo barra degli strumenti quando un pulsante sta per essere eliminato.
TBN_DRAGOUT Inviato da un controllo barra degli strumenti quando l'utente fa clic su un pulsante e quindi sposta il cursore fuori dal pulsante. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_DRAGOVER Verifica se un messaggio di TB_MARKBUTTON deve essere inviato per un pulsante trascinato. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_DROPDOWN Inviato da un controllo barra degli strumenti quando l'utente fa clic su un pulsante a discesa. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_DUPACCELERATOR Verifica se un tasto di scelta rapida può essere utilizzato su due o più barre degli strumenti attive. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_ENDADJUST Notifica alla finestra padre di una barra degli strumenti che l'utente ha smesso di personalizzare una barra degli strumenti. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_ENDDRAG Notifica alla finestra padre della barra degli strumenti che l'utente ha smesso di trascinare un pulsante in una barra degli strumenti. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_GETBUTTONINFO Recupera le informazioni di personalizzazione della barra degli strumenti e notifica alla finestra padre della barra degli strumenti eventuali modifiche apportate alla barra degli strumenti. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_GETDISPINFO Recupera le informazioni di visualizzazione per un elemento della barra degli strumenti. Questa notifica viene inviata sotto forma di messaggio di WM_NOTIFY.
TBN_GETINFOTIP Recupera le informazioni sulla descrizione informativa per un elemento della barra degli strumenti. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_GETOBJECT Inviato da un controllo barra degli strumenti che utilizza lo stile TBSTYLE_REGISTERDROP per richiedere un oggetto destinazione di rilascio quando il puntatore passa su uno dei relativi pulsanti. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_HOTITEMCHANGE Inviato da un controllo barra degli strumenti quando cambia l'elemento attivo (evidenziato). Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_INITCUSTOMIZE Notifica alla finestra padre di una barra degli strumenti che è stata avviata la personalizzazione. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_MAPACCELERATOR Richiede l'indice del pulsante nella barra degli strumenti corrispondente al carattere di scelta rapida specificato. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_QUERYDELETE Notifica alla finestra padre della barra degli strumenti se un pulsante può essere eliminato da una barra degli strumenti mentre l'utente sta personalizzando la barra degli strumenti. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_QUERYINSERT Notifica alla finestra padre della barra degli strumenti se è possibile inserire un pulsante a sinistra del pulsante specificato mentre l'utente sta personalizzando una barra degli strumenti. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_RESET Notifica alla finestra padre della barra degli strumenti che l'utente ha reimpostato il contenuto della finestra di dialogo Personalizza barra degli strumenti. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_RESTORE Notifica alla finestra padre di una barra degli strumenti che una barra degli strumenti sta per essere ripristinata. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_SAVE Notifica alla finestra padre di una barra degli strumenti che una barra degli strumenti sta per essere salvata. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_TOOLBARCHANGE Notifica alla finestra padre della barra degli strumenti che l'utente ha personalizzato una barra degli strumenti. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_WRAPACCELERATOR Richiede l'indice del pulsante in una o più barre degli strumenti corrispondenti al carattere di scelta rapida specificato. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
TBN_WRAPHOTITEM Notifica a un'applicazione due o più barre degli strumenti che l'elemento attivo sta per cambiare. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.

Strutture

Argomento Contenuto
COLORMAP Contiene informazioni usate dalla funzione CreateMappedBitmap per eseguire il mapping dei colori della bitmap.
NMTBCUSTOMDRAW Contiene informazioni specifiche di un NM_CUSTOMDRAW codice di notifica inviato da un controllo barra degli strumenti.
NMTBDISPINFO Contiene e riceve informazioni di visualizzazione per un elemento della barra degli strumenti. Questa struttura viene usata con il codice di notifica TBN_GETDISPINFO.
NMTBGETINFOTIP Contiene e riceve informazioni sulla descrizione informativa per un elemento della barra degli strumenti. Questa struttura viene usata con il codice di notifica TBN_GETINFOTIP.
NMTBHOTITEM Contiene informazioni utilizzate con il codice di notifica TBN_HOTITEMCHANGE.
NMTBRESTORE Consente alle applicazioni di estrarre le informazioni inserite in NMTBSAVE quando è stato salvato lo stato della barra degli strumenti. Questa struttura viene passata alle applicazioni quando ricevono un codice di notifica TBN_RESTORE.
NMTBSAVE Questa struttura viene passata alle applicazioni quando ricevono un codice di notifica TBN_SAVE. Contiene informazioni sul pulsante attualmente salvato. Le applicazioni possono modificare i valori dei membri per salvare informazioni aggiuntive.
NMTOOLBAR Contiene informazioni utilizzate per elaborare i codici di notifica della barra degli strumenti. Questa struttura sostituisce la struttura TBNOTIFY.
TBADDBITMAP Aggiunge una bitmap contenente immagini pulsante a una barra degli strumenti.
TBBUTTON Contiene informazioni su un pulsante in una barra degli strumenti.
TBBUTTONINFO Contiene o riceve informazioni per un pulsante specifico in una barra degli strumenti.
TBINSERTMARK Contiene informazioni sul segno di inserimento in un controllo barra degli strumenti.
TBMETRICS Definisce le metriche di una barra degli strumenti usata per compattare o espandere gli elementi della barra degli strumenti.
TBREPLACEBITMAP Usato con il messaggio TB_REPLACEBITMAP per sostituire una bitmap della barra degli strumenti con un'altra.
TBSAVEPARAMS Specifica il percorso nel Registro di sistema in cui l'TB_SAVERESTORE messaggio archivia e recupera informazioni sullo stato di una barra degli strumenti.

Costanti

Argomento Contenuto
degli stati dei pulsanti della barra degli strumenti In questa sezione sono elencati gli stati che un pulsante della barra degli strumenti può avere.
stili barra degli strumenti e pulsante 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 i controlli comuni versione 6.00, se viene usato un di stile di visualizzazione 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 o versioni successive. Per usare Comctl32.dll versione 6, specificarlo in un manifesto. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.
stili estesi della barra degli strumenti In questa sezione sono elencati gli stili estesi supportati dai controlli della barra degli strumenti.
valori dell'indice dell'immagine standard della barra degli strumenti Questa sezione specifica i valori di indice delle immagini all'interno di bitmap standard.