Struttura TCITEMHEADERA (commctrl.h)

  • Articolo

Specifica o riceve gli attributi di una scheda. Viene usato con i messaggi TCM_INSERTITEM, TCM_GETITEM e TCM_SETITEM . Questa struttura sostituisce la struttura TC_ITEMHEADER .

Sintassi

typedef struct tagTCITEMHEADERA {
  UINT  mask;
  UINT  lpReserved1;
  UINT  lpReserved2;
  LPSTR pszText;
  int   cchTextMax;
  int   iImage;
} TCITEMHEADERA, *LPTCITEMHEADERA;

Members

mask

Tipo: UINT

Valore che specifica i membri da recuperare o impostare. Questo membro può essere una combinazione dei valori seguenti:

Valore Significato
TCIF_IMAGE
 Il membro iImage è valido.
TCIF_RTLREADING
 La stringa puntata da pszText verrà visualizzata nella direzione opposta al testo nella finestra padre.
TCIF_TEXT
 Il membro pszText è valido.

lpReserved1

Tipo: UINT

Membro riservato. Non usare.

lpReserved2

Tipo: UINT

Membro riservato. Non usare.

pszText

Tipo: LPTSTR

Indirizzo di una stringa con terminazione null contenente il testo della scheda se vengono impostate le informazioni sull'elemento. Se vengono recuperate informazioni sull'elemento, questo membro specifica l'indirizzo del buffer che riceve il testo della scheda.

cchTextMax

Tipo: int

Dimensione del buffer a cui punta il membro pszText. Se la struttura non riceve informazioni, questo membro viene ignorato.

iImage

Tipo: int

Indice nell'elenco di immagini del controllo tabulazioni o -1 se non è presente alcuna immagine per la scheda.

Commenti

In genere, le finestre visualizzano testo da sinistra a destra (LTR). Windows può essere mirrorato per visualizzare lingue come ebraico o arabo che leggevano RTL (destra a sinistra). In genere, pszText verrà visualizzato nella stessa direzione del testo nella finestra padre. Se TCIF_RTLREADING è impostato, pszText leggerà nella direzione opposta dal testo nella finestra padre.

Nota

L'intestazione commctrl.h definisce TCITEMHEADER 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

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione commctrl.h