Condividi tramite

Struttura TCITEMHEADERA (commctrl.h)

  • Articolo

Specifica o riceve gli attributi di una scheda. Viene usato con i messaggi TCM_INSERTITEM, TCM_GETITEMe 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;

Membri

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 a cui punta 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 informazioni sull'elemento. Se vengono recuperate informazioni sugli elementi, 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

Indicizzare nell'elenco di immagini del controllo struttura a schede o -1 se non è presente alcuna immagine per la scheda.

Osservazioni

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, 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 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