Condividi tramite

Struttura HDITEMW (commctrl.h)

  • Articolo

Contiene informazioni su un elemento in un controllo intestazione. Questa struttura sostituisce la struttura HD_ITEM .

Sintassi

typedef struct _HD_ITEMW {
  UINT    mask;
  int     cxy;
  LPWSTR  pszText;
  HBITMAP hbm;
  int     cchTextMax;
  int     fmt;
  LPARAM  lParam;
  int     iImage;
  int     iOrder;
  UINT    type;
  void    *pvFilter;
  UINT    state;
} HDITEMW, *LPHDITEMW;

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
HDI_BITMAP
 Il membro hbm è valido.
HDI_DI_SETITEM
 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).
HDI_FORMAT
 Il membro fmt è valido.
HDI_FILTER
 I membri di tipo e pvFilter sono validi. Viene usato per filtrare i valori specificati nel membro del tipo .
HDI_HEIGHT
 Uguale a HDI_WIDTH.
HDI_IMAGE
 Il membro iImage è valido e specifica l'immagine da visualizzare con l'elemento.
HDI_LPARAM
 Il membro lParam è valido.
HDI_ORDER
 Il membro iOrder è valido e specifica il valore dell'ordine dell'elemento.
HDI_STATE

Versione 6.00 e successive. Il membro dello stato è valido.
HDI_TEXT
 I membri pszText e cchTextMax sono validi.
HDI_WIDTH
 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
Giustificazione del testo:
 Impostare uno dei flag seguenti per specificare la giustificazione del testo:
HDF_CENTER
 Il contenuto dell'elemento è centrato.
HDF_LEFT
 Il contenuto dell'elemento è allineato a sinistra.
HDF_RIGHT
 Il contenuto dell'elemento è allineato a destra.
Schermo:
 Impostare uno dei flag seguenti per controllare la visualizzazione:
HDF_BITMAP
 L'elemento visualizza una bitmap.
HDF_BITMAP_ON_RIGHT
 La bitmap viene visualizzata a destra del testo.
HDF_OWNERDRAW
 Il proprietario del controllo intestazione disegna l'elemento.
HDF_STRING
 L'elemento visualizza una stringa.
Combinazione di flag:
 Il valore precedente può essere combinato con:
HDF_IMAGE
 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.
HDF_JUSTIFYMASK
 Isolare i bit corrispondenti ai tre flag di giustificazione elencati nella tabella precedente.
HDF_RTLREADING
 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.
HDF_SORTDOWN

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.
HDF_SORTUP

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.
HDF_CHECKBOX

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.
HDF_CHECKED

Versione 6.00 e successiva. L'elemento visualizza una casella di controllo selezionata. Il flag è valido solo quando viene impostato HDF_CHECKBOX.
HDF_FIXEDWIDTH

Versione 6.00 e successiva. La larghezza dell'elemento non può essere modificata da un'azione utente per ridimensionarla.
HDF_SPLITBUTTON

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
HDFT_ISSTRING
 Dati stringa.
HDFT_ISNUMBER
 Dati numerici.
HDFT_HASNOVALUE
 Ignorare pvFilter.
HDFT_ISDATE

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
HDIS_FOCUSED
 L'elemento ha lo stato attivo sulla tastiera.

Commenti

Nota Comctl32.dll versione 6 non è ridistribuibile, ma è incluso in Windows. Per usare Comctl32.dll versione 6, specificarlo in un manifesto. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.
 

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