Struttura HDITEMA (commctrl.h)
Contiene informazioni su un elemento in un controllo intestazione. Questa struttura sostituisce la struttura HD_ITEM.
Sintassi
typedef struct _HD_ITEMA {
UINT mask;
int cxy;
LPSTR pszText;
HBITMAP hbm;
int cchTextMax;
int fmt;
LPARAM lParam;
int iImage;
int iOrder;
UINT type;
void *pvFilter;
UINT state;
} HDITEMA, *LPHDITEMA;
Membri
mask
Flag che indicano quali altri membri della struttura contengono dati validi o devono essere compilati. Questo membro può essere una combinazione dei valori seguenti:
| Valore | Significato |
|---|---|
|
Il membro hbm |
|
Durante la gestione del messaggio HDM_GETITEM, il controllo intestazione potrebbe non avere tutti i valori necessari per completare la richiesta. In questo caso, il controllo deve richiamare nuovamente l'applicazione per i valori tramite la notifica di HDN_GETDISPINFO. Se HDI_DI_SETITEM è stato passato nel messaggio di HDM_GETITEM, il controllo memorizza nella cache tutti i valori restituiti da HDN_GETDISPINFO (in caso contrario i valori rimangono non eseguiti). |
|
Il membro fmt è valido. |
|
I membri di tipo |
|
Uguale a HDI_WIDTH. |
|
Il membro iImage |
|
Il membro lParam |
|
Il membro iOrder |
|
versione 6.00 e successive. Lo stato membro è valido. |
|
I membri |
|
Il membro cxy |
cxy
Tipo: int
Larghezza o altezza dell'elemento.
pszText
Tipo: LPTSTR
Puntatore a una stringa di elemento. Se il testo viene recuperato dal controllo, questo membro deve essere inizializzato per puntare a un buffer di caratteri. Se questo membro è impostato su LPSTR_TEXTCALLBACK, il controllo richiederà informazioni di testo per questo elemento inviando un codice di notifica HDN_GETDISPINFO. Si noti che anche se il controllo intestazione consente di archiviare una stringa di qualsiasi lunghezza come testo dell'elemento, vengono visualizzati solo i primi 260 TCHAR.
hbm
Handle per la bitmap dell'elemento.
cchTextMax
Tipo: int
Lunghezza della stringa dell'elemento, in TCHAR. Se il testo viene recuperato dal controllo, questo membro deve contenere il numero di
fmt
Tipo: int
Flag che specificano il formato dell'elemento.
| Valore | Significato |
|---|---|
|
Impostare uno dei flag seguenti per specificare la giustificazione del testo: |
|
Il contenuto dell'elemento è centrato. |
|
Il contenuto dell'elemento è allineato a sinistra. |
|
Il contenuto dell'elemento è allineato a destra. |
|
Impostare uno dei flag seguenti per controllare la visualizzazione: |
|
L'elemento visualizza una bitmap. |
|
La bitmap viene visualizzata a destra del testo. |
|
Il proprietario del controllo intestazione disegna l'elemento. |
|
L'elemento visualizza una stringa. |
|
Il valore precedente può essere combinato con: |
|
Visualizzare un'immagine da un elenco di immagini. Specificare l'elenco di immagini inviando un messaggio di HDM_SETIMAGELIST. Specificare l'indice dell'immagine nel membro iImage di questa struttura. |
|
Isolare i bit corrispondenti ai tre flag di giustificazione elencati nella tabella precedente. |
|
In genere, le finestre visualizzano testo da sinistra a destra (LTR). Windows può essere con mirroring per visualizzare lingue come l'ebraico o l'arabo che leggono da destra a sinistra (RTL). In genere, il testo dell'intestazione viene letto nella stessa direzione del testo nella finestra padre. Se HDF_RTLREADING è impostato, il testo dell'intestazione leggerà nella direzione opposta dal testo nella finestra padre. |
|
versione 6.00 e successive. Disegna una freccia giù su questo elemento. Viene in genere utilizzato per indicare che le informazioni nella finestra corrente sono ordinate in base a questa colonna in ordine decrescente. Questo flag non può essere combinato con HDF_IMAGE o HDF_BITMAP. |
|
versione 6.00 e successive. Disegna una freccia su questo elemento. Viene in genere utilizzato per indicare che le informazioni nella finestra corrente vengono ordinate in base a questa colonna in ordine crescente. Questo flag non può essere combinato con HDF_IMAGE o HDF_BITMAP. |
|
versione 6.00 e successive. L'elemento visualizza una casella di controllo. Il flag è valido solo quando lo stile di HDS_CHECKBOXES viene impostato per la prima volta nel controllo intestazione. |
|
versione 6.00 e successive. L'elemento visualizza una casella di controllo selezionata. Il flag è valido solo quando viene impostata anche HDF_CHECKBOX. |
|
versione 6.00 e successive. La larghezza dell'elemento non può essere modificata da un'azione dell'utente per ridimensionarla. |
|
versione 6.00 e successive. L'elemento visualizza un pulsante di divisione. La notifica HDN_DROPDOWN viene inviata quando si fa clic sul pulsante di divisione. |
lParam
Tipo: LPARAM
Dati degli elementi definiti dall'applicazione.
iImage
Tipo: int
Indice in base zero di un'immagine all'interno dell'elenco di immagini. L'immagine specificata verrà visualizzata nell'elemento di intestazione oltre a qualsiasi immagine specificata nel campo hbm
iOrder
Tipo: int
Ordine in cui l'elemento viene visualizzato all'interno del controllo intestazione, da sinistra a destra. Ovvero, il valore per l'elemento all'estrema sinistra è 0. Il valore per l'elemento successivo a destra è 1 e così via.
type
Tipo di filtro specificato da pvFilter. I tipi possibili includono:
| Valore | Significato |
|---|---|
|
Dati stringa. |
|
Dati numerici. |
|
Ignorare pvFilter. |
|
versione 6.00 e successive. Dati relativi alla data. Il membro pvFilter |
pvFilter
Tipo: void*
Indirizzo di un elemento di dati definito dall'applicazione. Il tipo di filtro dati è determinato impostando il valore del flag del membro. Usare il flag HDFT_ISSTRING per indicare una stringa e HDFT_ISNUMBER per indicare un numero intero. Quando si usa il flag HDFT_ISSTRING pvFilter è un puntatore a una struttura HDTEXTFILTER.
state
Stato. L'unico valore valido e supportato per questo membro è il seguente:
| Valore | Significato |
|---|---|
|
L'elemento ha lo stato attivo della tastiera. |
Osservazioni
Nota
L'intestazione commctrl.h definisce HDITEM come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista [solo app desktop] |
| server minimo supportato | Windows Server 2003 [solo app desktop] |
| intestazione |
commctrl.h |