Condividi tramite


Controllo intestazione

Questa sezione contiene informazioni sugli elementi di programmazione usati con i controlli intestazione.

Panoramiche

Argomento Contenuto
Informazioni sui controlli intestazione Un controllo intestazione è una finestra in genere posizionata sopra le colonne di testo o numeri. Contiene un titolo per ogni colonna e può essere diviso in parti.
Uso dei controlli intestazione In questo argomento vengono forniti dettagli di implementazione ed esempi di codice per i controlli di intestazione.

Macro

Argomento Contenuto
Header_ClearAllFilters Cancella tutti i filtri per un determinato controllo intestazione. È possibile utilizzare questa macro o inviare il messaggio di HDM_CLEARFILTER in modo esplicito.
Header_ClearFilter Cancella il filtro per un determinato controllo intestazione. È possibile utilizzare questa macro o inviare il messaggio di HDM_CLEARFILTER in modo esplicito.
Header_CreateDragImage Crea una versione trasparente di un'immagine di elemento all'interno di un controllo intestazione esistente. È possibile utilizzare questa macro o inviare il messaggio di HDM_CREATEDRAGIMAGE in modo esplicito.
Header_DeleteItem Elimina un elemento da un controllo intestazione. È possibile utilizzare questa macro o inviare il messaggio di HDM_DELETEITEM in modo esplicito.
Header_EditFilter Sposta lo stato attivo dell'input nella casella di modifica quando un pulsante filtro ha lo stato attivo.
Header_GetBitmapMargin Ottiene la larghezza del margine (in pixel) di una bitmap in un controllo intestazione esistente. È possibile utilizzare questa macro o inviare il messaggio di HDM_GETBITMAPMARGIN in modo esplicito.
Header_GetFocusedItem Ottiene l'elemento in un controllo intestazione con lo stato attivo. Utilizzare questa macro o inviare il messaggio HDM_GETFOCUedizione Standard DITEM in modo esplicito.
Header_GetImageList Ottiene l'handle per l'elenco di immagini impostato per un controllo intestazione esistente. È possibile utilizzare questa macro o inviare il messaggio di HDM_GETIMAGELIST in modo esplicito.
Header_GetItem Ottiene informazioni su un elemento in un controllo intestazione. È possibile utilizzare questa macro o inviare il messaggio di HDM_GETITEM in modo esplicito.
Header_GetItemCount Ottiene un conteggio degli elementi in un controllo intestazione. È possibile utilizzare questa macro o inviare il messaggio di HDM_GETITEMCOUNT in modo esplicito.
Header_GetItemDropDownRect Ottiene le coordinate del pulsante a discesa per un elemento specificato in un controllo intestazione. Il controllo intestazione deve essere di tipo HDF_SPLITBUTTON. Utilizzare questa macro o inviare il messaggio di HDM_GETITEMDROPDOWNRECT in modo esplicito.
Header_GetItemRect Ottiene il rettangolo di delimitazione per un determinato elemento in un controllo intestazione. È possibile utilizzare questa macro o inviare il messaggio di HDM_GETITEMRECT in modo esplicito.
Header_GetOrderArray Ottiene l'ordine corrente da sinistra a destra degli elementi in un controllo intestazione. È possibile utilizzare questa macro o inviare il messaggio di HDM_GETORDERARRAY in modo esplicito.
Header_GetOverflowRect Ottiene le coordinate dell'area di overflow a discesa per un controllo intestazione specificato. Il controllo intestazione deve essere di tipo HDF_SPLITBUTTON. Utilizzare questa macro o inviare il messaggio di HDM_GETOVERFLOWRECT in modo esplicito.
Header_GetStateImageList Ottiene l'handle per l'elenco di immagini impostato per uno stato di controllo intestazione esistente.
Header_GetUnicodeFormat Ottiene il flag di formato carattere Unicode per il controllo . È possibile utilizzare questa macro o inviare il messaggio di HDM_GETUNICODEFORMAT in modo esplicito.
Header_InsertItem Inserisce un nuovo elemento in un controllo intestazione. È possibile utilizzare questa macro o inviare in modo esplicito il messaggio HDM_INedizione Standard RTITEM.
Header_Layout Recupera le dimensioni e la posizione corrette di un controllo intestazione all'interno della finestra padre. È possibile utilizzare questa macro o inviare il messaggio di HDM_LAYOUT in modo esplicito.
Header_OrderToIndex Recupera un valore di indice per un elemento in base al relativo ordine nel controllo intestazione. È possibile utilizzare questa macro o inviare il messaggio di HDM_ORDERTOINDEX in modo esplicito.
Header_SetBitmapMargin Imposta la larghezza del margine per una bitmap in un controllo intestazione esistente. È possibile usare questa macro o inviare il messaggio HDM_edizione Standard TBITMAPMARGIN in modo esplicito.
Header_SetFilterChangeTimeout Imposta l'intervallo di timeout tra il momento in cui viene apportata una modifica negli attributi del filtro e la registrazione di una notifica di HDN_FILTERCHANGE . È possibile utilizzare questa macro o inviare il messaggio HDM_edizione Standard TFILTERCHANGETIMEOUT in modo esplicito.
Header_SetFocusedItem Imposta lo stato attivo su un elemento specificato in un controllo intestazione. Utilizzare questa macro o inviare in modo esplicito il messaggio HDM_edizione Standard TFOCU edizione Standard DITEM.
Header_SetHotDivider Modifica il colore di un divisore tra gli elementi dell'intestazione per indicare la destinazione di un'operazione di trascinamento della selezione esterna. È possibile utilizzare questa macro o inviare il messaggio HDM_edizione Standard THOTDIVIDER in modo esplicito.
Header_SetImageList Assegna un elenco di immagini a un controllo intestazione esistente. È possibile utilizzare questa macro o inviare il messaggio HDM_edizione Standard TIMAGELIST in modo esplicito.
Header_SetItem Imposta gli attributi dell'elemento specificato in un controllo intestazione. È possibile utilizzare questa macro o inviare il messaggio HDM_edizione Standard TITEM in modo esplicito.
Header_SetOrderArray Imposta l'ordine da sinistra a destra degli elementi di intestazione. È possibile utilizzare questa macro o inviare il messaggio HDM_edizione Standard TORDERARRAY in modo esplicito.
Header_SetStateImageList Assegna un elenco di immagini a uno stato di controllo intestazione esistente.
Header_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. È possibile utilizzare questa macro o inviare il messaggio HDM_edizione Standard TUNICODEFORMAT in modo esplicito.

Messaggi

Argomento Contenuto
HDM_CLEARFILTER Cancella il filtro per un determinato controllo intestazione. È possibile inviare questo messaggio in modo esplicito o usare la macro Header_ClearFilter.
HDM_CREATEDRAGIMAGE Crea una versione semitrasparente dell'immagine di un elemento da usare come immagine di trascinamento. È possibile inviare questo messaggio in modo esplicito o usare la macro Header_CreateDragImage.
HDM_DELETEITEM Elimina un elemento da un controllo intestazione. È possibile inviare questo messaggio in modo esplicito o utilizzare la macro Header_DeleteItem.
HDM_EDITFILTER Sposta lo stato attivo dell'input nella casella di modifica quando un pulsante filtro ha lo stato attivo.
HDM_GETBITMAPMARGIN Ottiene la larghezza del margine bitmap per un controllo intestazione. È possibile inviare questo messaggio in modo esplicito o usare la macro Header_GetBitmapMargin.
HDM_GETFOCUedizione Standard DITEM Ottiene l'elemento in un controllo intestazione con lo stato attivo. Inviare questo messaggio in modo esplicito o utilizzando la macro Header_GetFocusedItem. Una finestra riceve questo messaggio tramite la relativa funzione WindowProc.
HDM_GETIMAGELIST Ottiene l'handle per l'elenco di immagini impostato per un controllo intestazione esistente. È possibile inviare questo messaggio in modo esplicito o utilizzare la macro Header_GetImageList o Header_GetStateImageList.
HDM_GETITEM Ottiene informazioni su un elemento in un controllo intestazione. È possibile inviare questo messaggio in modo esplicito o utilizzare la macro Header_GetItem.
HDM_GETITEMCOUNT Ottiene un conteggio degli elementi in un controllo intestazione. È possibile inviare questo messaggio in modo esplicito o usare la macro Header_GetItemCount.
HDM_GETITEMDROPDOWNRECT Ottiene il rettangolo di delimitazione del pulsante di divisione per un elemento di intestazione con stile HDF_SPLITBUTTON. Inviare questo messaggio in modo esplicito o tramite lamacro Header_GetItemDropDownRect.
HDM_GETITEMRECT Ottiene il rettangolo di delimitazione per un determinato elemento in un controllo intestazione. È possibile inviare questo messaggio in modo esplicito o utilizzare la macro Header_GetItemRect.
HDM_GETORDERARRAY Ottiene l'ordine corrente da sinistra a destra degli elementi in un controllo intestazione. È possibile inviare questo messaggio in modo esplicito o utilizzare la macro Header_GetOrderArray.
HDM_GETOVERFLOWRECT Ottiene il rettangolo di delimitazione del pulsante di overflow quando lo stile HDS_OVERFLOW è impostato sul controllo intestazione e il pulsante di overflow è visibile. Inviare questo messaggio in modo esplicito o tramite lamacro Header_GetOverflowRect.
HDM_GETUNICODEFORMAT Ottiene il flag di formato carattere Unicode per il controllo . È possibile inviare questo messaggio in modo esplicito o usare la macro Header_GetUnicodeFormat.
HDM_HITTEST Verifica un punto per determinare quale elemento di intestazione, se presente, si trova nel punto specificato.
HDM_INedizione Standard RTITEM Inserisce un nuovo elemento in un controllo intestazione. È possibile inviare questo messaggio in modo esplicito o utilizzare la macro Header_InsertItem.
HDM_LAYOUT Recupera le informazioni utilizzate per impostare le dimensioni e la posizione del controllo intestazione all'interno del rettangolo di destinazione della finestra padre. È possibile inviare questo messaggio in modo esplicito o utilizzare la macro Header_Layout.
HDM_ORDERTOINDEX Recupera un valore di indice per un elemento in base al relativo ordine nel controllo intestazione. È possibile inviare questo messaggio in modo esplicito o utilizzare la macro Header_OrderToIndex.
HDM_edizione Standard TBITMAPMARGIN Imposta la larghezza del margine, specificata in pixel, di una bitmap in un controllo intestazione esistente. È possibile inviare questo messaggio in modo esplicito o usare la macro Header_SetBitmapMargin.
HDM_edizione Standard TFILTERCHANGETIMEOUT Imposta l'intervallo di timeout tra il momento in cui viene apportata una modifica negli attributi del filtro e la registrazione di una notifica di HDN_FILTERCHANGE . È possibile inviare questo messaggio in modo esplicito o usare la macro Header_SetFilterChangeTimeout.
HDM_edizione Standard TFOCU edizione Standard DITEM Imposta lo stato attivo su un elemento specificato in un controllo intestazione. Inviare questo messaggio in modo esplicito o tramite la macro Header_SetFocusedItem.
HDM_edizione Standard THOTDIVIDER Modifica il colore di un divisore tra gli elementi dell'intestazione per indicare la destinazione di un'operazione di trascinamento della selezione esterna. È possibile inviare questo messaggio in modo esplicito o utilizzare la macro Header_SetHotDivider.
HDM_edizione Standard TIMAGELIST Assegna un elenco di immagini a un controllo intestazione esistente. È possibile inviare questo messaggio in modo esplicito o usare la macro Header_SetImageList o Header_SetStateImageList.
HDM_edizione Standard TITEM Imposta gli attributi dell'elemento specificato in un controllo intestazione. È possibile inviare questo messaggio in modo esplicito o usare la macro Header_SetItem.
HDM_edizione Standard TORDERARRAY Imposta l'ordine da sinistra a destra degli elementi di intestazione. È possibile inviare questo messaggio in modo esplicito o utilizzare la macro Header_SetOrderArray.
HDM_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. È possibile inviare questo messaggio in modo esplicito o usare la macro Header_SetUnicodeFormat.
HDM_TRANSLATEACCELERATOR Non implementata.

Notifications

Argomento Contenuto
HDN_BEGINDRAG Inviato da un controllo intestazione quando un'operazione di trascinamento è iniziata su uno dei relativi elementi. Questo codice di notifica viene inviato solo dai controlli intestazione impostati sullo stile HDS_DRAGDROP. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
HDN_BEGINFILTEREDIT Notifica alla finestra padre di un controllo di intestazione che è stata avviata una modifica del filtro. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
HDN_BEGINTRACK Notifica alla finestra padre di un controllo intestazione che l'utente ha iniziato a trascinare un divisore nel controllo, ovvero l'utente ha premuto il pulsante sinistro del mouse mentre il cursore del mouse si trova su un divisore nel controllo intestazione. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
HDN_DIVIDERDBLCLICK Notifica alla finestra padre di un controllo intestazione che l'utente ha fatto doppio clic sull'area di divisione del controllo. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
HDN_DROPDOWN Inviato da un controllo intestazione al relativo elemento padre quando si fa clic sulla freccia a discesa nel controllo intestazione. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
HDN_ENDDRAG Inviato da un controllo intestazione quando un'operazione di trascinamento è terminata su uno dei relativi elementi. Questo codice di notifica viene inviato come messaggio di WM_NOTIFY. Solo i controlli intestazione impostati sullo stile di HDS_DRAGDROP inviano questa notifica.
HDN_ENDFILTEREDIT Notifica alla finestra padre di un controllo di intestazione che una modifica del filtro è terminata. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
HDN_ENDTRACK Notifica alla finestra padre di un controllo intestazione che l'utente ha terminato di trascinare un divisore. Questo codice di notifica inviato sotto forma di messaggio di WM_NOTIFY .
HDN_FILTERBTNCLICK Notifica alla finestra padre del controllo intestazione quando si fa clic sul pulsante filtro o in risposta a un messaggio HDM_edizione Standard TITEM.
HDN_FILTERCHANGE Notifica alla finestra padre del controllo intestazione che gli attributi di un filtro di controllo intestazione vengono modificati o modificati.
HDN_GETDISPINFO Inviato al proprietario di un controllo intestazione quando il controllo necessita di informazioni su un elemento di intestazione di callback. Questo codice di notifica viene inviato come messaggio di WM_NOTIFY.
HDN_ITEMCHANGED Notifica alla finestra padre di un controllo intestazione che gli attributi di un elemento di intestazione sono stati modificati. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
HDN_ITEMCHANGING Notifica alla finestra padre di un controllo intestazione che gli attributi di un elemento di intestazione stanno per cambiare. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
HDN_ITEMCLICK Notifica alla finestra padre di un controllo di intestazione che l'utente ha fatto clic sul controllo. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
HDN_ITEMDBLCLICK Notifica alla finestra padre di un controllo di intestazione che l'utente ha fatto doppio clic sul controllo. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY. Solo i controlli intestazione impostati sullo stile di HDS_BUTTONS inviano questa notifica.
HDN_ITEMKEYDOWN Notifica alla finestra padre di un controllo intestazione che un tasto è stato premuto con un elemento selezionato. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
HDN_ITEMSTATEICONCLICK Notifica alla finestra padre di un controllo intestazione che l'utente ha fatto clic sull'icona dello stato di un elemento.
HDN_OVERFLOWCLICK Inviato da un controllo intestazione al relativo elemento padre quando si fa clic sul pulsante di overflow dell'intestazione. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY .
HDN_TRACK Notifica alla finestra padre di un controllo di intestazione che l'utente sta trascinando un divisore nel controllo intestazione. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
NM_CUSTOMDRAW (intestazione) Inviato da un controllo intestazione per notificare alla finestra padre le operazioni di disegno. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.
NM_RCLICK (intestazione) Notifica alla finestra padre di un controllo visualizzazione albero che l'utente ha fatto 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 (intestazione) Notifica alla finestra padre di un controllo di intestazione che il controllo sta rilasciando l'acquisizione del mouse. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY.

Costanti

Argomento Contenuto
Stili di controllo intestazione I controlli intestazione hanno diversi stili, descritti in questa sezione, che determinano l'aspetto e il comportamento del controllo. Gli stili iniziali vengono impostati quando si crea il controllo intestazione.