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. L'utente può trascinare i divisori che separano le parti per impostare la larghezza di ogni colonna. La figura seguente mostra un controllo intestazione con etichette di colonne che forniscono informazioni dettagliate sui file in una directory.

È possibile creare un controllo intestazione usando la funzione CreateWindowEx, specificando la classe della finestra WC_HEADER e gli stili di controllo intestazione appropriati. Questa classe finestra viene registrata quando viene caricata la DLL del controllo comune. Per assicurarsi che questa DLL venga caricata, usare la funzione InitCommonControlsEx. Dopo aver creato un controllo intestazione, è possibile dividerlo in parti, impostare il testo in ogni parte e controllare l'aspetto della finestra usando i messaggi della finestra di intestazione.

Un controllo intestazione può essere creato come finestra figlio di un altro controllo, ad esempio una casella di riepilogo. Tuttavia, il controllo padre non riconosce il controllo intestazione e non consente lo spazio occupato dall'intestazione, con il risultato che gli elementi dell'elenco verranno visualizzati dietro l'intestazione. Se si desidera utilizzare un controllo intestazione in una casella di riepilogo o in un altro controllo, il controllo padre deve essere disegnato dal proprietario in modo che tutti gli elementi vengano visualizzati nella posizione corretta.

I controlli visualizzazione elenco dispongono già di controlli intestazione. Anziché creare un controllo intestazione per un controllo visualizzazione elenco, è possibile utilizzare LVM_GETHEADER o ListView_GetHeader per recuperare il controllo esistente.

• Dimensioni e posizione del controllo intestazione
• Articoli
• Controlli intestazione disegnati dal proprietario
• Filtri di controllo intestazione
• Elaborazione dei messaggi di controllo intestazione predefinita

Dimensioni e posizione del controllo intestazione

In genere, è necessario impostare le dimensioni e la posizione di un controllo intestazione in modo da adattarsi entro i limiti di un particolare rettangolo, ad esempio l'area client di una finestra. Usando il messaggio HDM_LAYOUT , è possibile recuperare le dimensioni e i valori di posizione appropriati dal controllo intestazione.

Quando si invia HDM_LAYOUT, si specifica l'indirizzo di una struttura HDLAYOUT che contiene le coordinate del rettangolo che il controllo intestazione deve occupare e fornisce un puntatore a una struttura WINDOWPOS. Il controllo riempie la struttura WINDOWPOS con valori di dimensione e posizione appropriati per posizionare il controllo lungo la parte superiore del rettangolo specificato. Il valore di altezza è la somma delle altezze dei bordi orizzontali del controllo e l'altezza media dei caratteri nel tipo di carattere attualmente selezionato nel contesto del dispositivo del controllo.

Se si desidera utilizzare HDM_LAYOUT per impostare le dimensioni iniziali e la posizione di un controllo intestazione, impostare lo stato di visibilità iniziale del controllo in modo che sia nascosto. Dopo aver inviato HDM_LAYOUT per recuperare le dimensioni e i valori di posizione, è possibile usare la funzione SetWindowPos per impostare le nuove dimensioni, posizione e stato di visibilità.

Articoli

Un controllo intestazione include in genere diversi elementi di intestazione che definiscono le colonne del controllo. Aggiungere un elemento a un controllo intestazione inviando il messaggio HDM_INedizione Standard RTITEM al controllo . Il messaggio include l'indirizzo di una struttura HDITEM . Questa struttura definisce le proprietà dell'elemento di intestazione, che possono includere una stringa, un'immagine bitmap, una dimensione iniziale e un valore LPARAM definito dall'applicazione.

Il membro fmt della struttura HDITEM di un elemento può includere il flag HDF_STRING o HDF_BITMAP per indicare se il controllo visualizza la stringa o la bitmap dell'elemento. Se si desidera visualizzare sia una stringa che una bitmap, creare un elemento disegnato dal proprietario impostando il membro fmt per includere il flag HDF_OWNERDRAW. La struttura HDITEM specifica anche flag di formattazione che indicano al controllo se allineare al centro, allineare a sinistra o allineare a destra la stringa o la bitmap nel rettangolo dell'elemento.

HDM_INedizione Standard RTITEM restituisce l'indice dell'elemento appena aggiunto. È possibile utilizzare l'indice in altri messaggi per impostare proprietà o recuperare informazioni sull'elemento. È possibile eliminare un elemento usando il messaggio HDM_DELETEITEM , specificando l'indice dell'elemento da eliminare.

È possibile utilizzare il messaggio HDM_edizione Standard TITEM per impostare le proprietà di un elemento di intestazione esistente e il messaggio HDM_GETITEM per recuperare le proprietà correnti di un elemento. Per recuperare un conteggio degli elementi in un controllo intestazione, utilizzare il messaggio HDM_GETITEMCOUNT.

Controlli intestazione disegnati dal proprietario

È possibile definire singoli elementi di un controllo intestazione per essere elementi disegnati dal proprietario. L'uso di questa tecnica offre un maggiore controllo rispetto all'aspetto di un elemento di intestazione.

È possibile utilizzare il messaggio HDM_INedizione Standard RTITEM per inserire un nuovo elemento disegnato dal proprietario in un controllo intestazione o nel messaggio HDM_edizione Standard TITEM per modificare un elemento esistente in un elemento disegnato dal proprietario. Entrambi i messaggi includono l'indirizzo di una struttura HDITEM, che deve avere il membro fmt impostato sul valore HDF_OWNERDRAW.

Quando un controllo intestazione deve disegnare un elemento disegnato dal proprietario, invia il messaggio di WM_DRAWITEM alla finestra padre. Il parametro wParam del messaggio è l'identificatore della finestra figlio del controllo intestazione e il parametro lParam è un indirizzo di una struttura DRAWITEMSTRUCT . La finestra padre utilizza le informazioni nella struttura per disegnare l'elemento. Per un elemento disegnato dal proprietario in un controllo intestazione, la struttura DRAWITEMSTRUCT contiene le informazioni seguenti.

Filtri di controllo intestazione

Specificando lo stile della finestra HDS_FILTERBAR per un controllo intestazione, è possibile abilitare il posizionamento delle caselle di modifica del filtro sotto le intestazioni di colonna. Accanto alla casella di modifica viene visualizzato un pulsante filtro. È possibile implementare il filtro rispondendo ai codici di notifica di HDN_BEGINFILTEREDIT, HDN_ENDFILTEREDIT, HDN_FILTERBTNCLICK o HDN_FILTERCHANGE .

Per impostazione predefinita, la casella di modifica contiene una richiesta all'utente di immettere testo. È possibile ripristinare lo stato predefinito della casella di modifica usando Header_ClearFilter o Header_ClearAllFilters.

Nell'esempio di codice seguente viene illustrato come recuperare il controllo intestazione da un controllo visualizzazione elenco e aggiungere una barra dei filtri.

// hList is the HWND of the list-view control.
HWND hHeader = ListView_GetHeader(hList);
LONG_PTR styles = GetWindowLongPtr(hHeader, GWL_STYLE);
SetWindowLongPtr(g_hHeader, GWL_STYLE, styles | HDS_FILTERBAR);

Elaborazione dei messaggi di controllo intestazione predefinita

In questa sezione vengono descritti i messaggi della finestra gestiti dalla routine della finestra per la classe finestra WC_HEADER .