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;
Members
mask
Tipo: UINT
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 è valido. |
|
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 e pvFilter sono validi. Viene usato per filtrare i valori specificati nel membro del tipo . |
|
Uguale a HDI_WIDTH. |
|
Il membro iImage è valido e specifica l'immagine da visualizzare con l'elemento. |
|
Il membro lParam è valido. |
|
Il membro iOrder è valido e specifica il valore dell'ordine dell'elemento. |
|
Versione 6.00 e successive. Il membro dello stato è valido. |
|
I membri pszText e cchTextMax sono validi. |
|
Il membro cxy è valido e specifica la larghezza dell'elemento. |
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
Tipo: HBITMAP
Handle per la bitmap dell'elemento.
cchTextMax
Tipo: int
Lunghezza della stringa dell'elemento, in TCHARs. Se il testo viene recuperato dal controllo , questo membro deve contenere il numero di S TCHARnell'indirizzo specificato da pszText.
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 il testo da sinistra a destra (LTR). È possibile eseguire il mirroring di Windows 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 verso il basso su questo elemento. Questa operazione viene in genere utilizzata per indicare che le informazioni nella finestra corrente vengono 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. Questa operazione viene in genere utilizzata 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 HDS_CHECKBOXES viene prima impostato sul controllo intestazione. |
|
Versione 6.00 e successiva. L'elemento visualizza una casella di controllo selezionata. Il flag è valido solo quando viene impostato HDF_CHECKBOX. |
|
Versione 6.00 e successiva. La larghezza dell'elemento non può essere modificata da un'azione utente per ridimensionarla. |
|
Versione 6.00 e successiva. L'elemento visualizza un pulsante di divisione. La notifica HDN_DROPDOWN viene inviata quando viene fatto clic sul pulsante di divisione. |
lParam
Tipo: LPARAM
Dati dell'elemento 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 dell'intestazione oltre a qualsiasi immagine specificata nel campo hbm . Se iImage è impostato su I_IMAGECALLBACK, il controllo richiede informazioni di testo per questo elemento usando un codice di notifica HDN_GETDISPINFO . Per cancellare l'immagine, impostare questo valore su I_IMAGENONE.
iOrder
Tipo: int
Ordine in cui l'elemento viene visualizzato all'interno del controllo intestazione, da sinistra a destra. Vale a dire, il valore per l'elemento a sinistra lontano è 0. Il valore per l'elemento successivo a destra è 1 e così via.
type
Tipo: UINT
Tipo di filtro specificato da pvFilter. I tipi possibili includono:
Valore | Significato |
---|---|
|
Dati stringa. |
|
Dati numerici. |
|
Ignorare pvFilter. |
|
Versione 6.00 e successiva. Dati di data. Il membro pvFilter è un puntatore a una struttura SYSTEMTIME . |
pvFilter
Tipo: void*
Indirizzo di un elemento 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 viene usato il flag HDFT_ISSTRING pvFilter è un puntatore a una struttura HDTEXTFILTER .
state
Tipo: UINT
Stato. L'unico valore valido e supportato per questo membro è il seguente:
Valore | Significato |
---|---|
|
L'elemento ha lo stato attivo sulla tastiera. |
Commenti
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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Intestazione | commctrl.h |
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per