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 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 in una barra degli strumenti corrispondono agli elementi nel menu dell'applicazione e forniscono all'utente un ulteriore modo più diretto di accedere ai controlli di un'applicazione.
Uso dei 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. Usare invece 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 struttura TBBUTTON.
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_GETINedizione Standard RTMARK Recupera il segno di inserimento corrente per la barra degli strumenti.
TB_GETINedizione Standard RTMARKCOLOR 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 IDropTarget per un controllo barra degli strumenti.
TB_GETPADDING Recupera la spaziatura interna per un controllo barra degli strumenti.
TB_GETPRESedizione Standard DIMAGELIST 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_INedizione Standard RTBUTTON Inserisce un pulsante in una barra degli strumenti.
TB_INedizione Standard RTMARKHITTEST 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_ISBUTTONPRESedizione Standard D 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_edizione Standard TANCHORHIGHLIGHT Imposta l'impostazione di evidenziazione dell'ancoraggio per una barra degli strumenti.
TB_edizione Standard TBITM piattaforma di strumenti analitici IZE Imposta le dimensioni delle immagini bitmap da aggiungere a una barra degli strumenti.
TB_edizione Standard TBOUNDINGSIZE 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_edizione Standard TBUTTONINFO Imposta le informazioni per un pulsante esistente in una barra degli strumenti.
TB_edizione Standard TBUTTONSIZE Imposta le dimensioni dei pulsanti su una barra degli strumenti.
TB_edizione Standard TBUTTONWIDTH Imposta la larghezza minima e massima dei pulsanti nel controllo barra degli strumenti.
TB_edizione Standard TCMDID Imposta l'identificatore del comando di un pulsante della barra degli strumenti.
TB_edizione Standard TCOLORSCHEME Imposta le informazioni sulla combinazione di colori per il controllo barra degli strumenti.
TB_edizione Standard TDISABLEDIMAGELIST Imposta l'elenco di immagini che verrà utilizzato dal controllo barra degli strumenti per visualizzare i pulsanti disabilitati.
TB_edizione Standard TDRAWTEXTFLAGS Imposta i flag di disegno di testo per la barra degli strumenti.
TB_edizione Standard TEXTENDEDSTYLE Imposta gli stili estesi per un controllo barra degli strumenti.
TB_edizione Standard THOTIMAGELIST Imposta l'elenco di immagini che verrà utilizzato dal controllo barra degli strumenti per visualizzare i pulsanti di scelta rapida.
TB_edizione Standard THOTITEM Imposta l'elemento attivo in una barra degli strumenti.
TB_edizione StandardTHOTITEM2 Imposta l'elemento attivo in una barra degli strumenti.
TB_edizione Standard TIMAGELIST Imposta l'elenco di immagini utilizzato dalla barra degli strumenti per visualizzare i pulsanti nello stato predefinito.
TB_edizione Standard TINDENT Imposta il rientro per il primo pulsante in un controllo barra degli strumenti.
TB_edizione Standard TIN edizione Standard RTMARK Imposta il segno di inserimento corrente per la barra degli strumenti.
TB_edizione Standard TIN edizione Standard RTMARKCOLOR Imposta il colore utilizzato per disegnare il segno di inserimento per la barra degli strumenti.
TB_edizione Standard TLISTGAP Imposta la distanza tra i pulsanti della barra degli strumenti su una barra degli strumenti specifica.
TB_edizione Standard TMAXTEXTROWS Imposta il numero massimo di righe di testo visualizzate su un pulsante della barra degli strumenti.
TB_edizione Standard TMETRICS Imposta le metriche di un controllo barra degli strumenti.
TB_edizione Standard TPADDING Imposta la spaziatura interna per un controllo barra degli strumenti.
TB_edizione Standard TPARENT Imposta la finestra su cui il controllo della barra degli strumenti invia codici di notifica.
TB_edizione Standard TPRES edizione Standard DIMAGELIST Imposta l'elenco di immagini utilizzato dalla barra degli strumenti per visualizzare i pulsanti in uno stato premuto.
TB_edizione Standard TROWS Imposta il numero di righe di pulsanti in una barra degli strumenti.
TB_edizione Standard TSTATE Imposta lo stato per il pulsante specificato in una barra degli strumenti.
TB_edizione Standard TSTYLE Imposta lo stile per un controllo barra degli strumenti.
TB_edizione Standard TTOOLTIPS Associa un controllo descrizione comando a una barra degli strumenti.
TB_edizione Standard TUNICODEFORMAT 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_edizione Standard TWINDOWTHEME Imposta lo stile di visualizzazione di un controllo barra degli strumenti.
TB_TRANSLATEACCELERATOR Passa un messaggio da tastiera alla barra degli strumenti.

Notifications

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_RELEAedizione Standard DCAPTURE (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_QUERYINedizione Standard RT 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_REedizione Standard T 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 utilizzate 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.
TBIN edizione Standard RTMARK 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
Stati pulsante barra degli strumenti In questa sezione sono elencati gli stati che un pulsante della barra degli strumenti può avere.
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 i controlli comuni versione 6.00, se viene usato uno 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 del pulsante standard della barra degli strumenti Questa sezione specifica i valori di indice delle immagini all'interno di bitmap standard.