Struttura TCITEMA (commctrl.h)

Specifica o riceve gli attributi di un elemento di tabulazioni. Viene usato con i messaggi TCM_INSERTITEM, TCM_GETITEMe TCM_SETITEM. Questa struttura sostituisce la struttura TC_ITEM.

Sintassi

typedef struct tagTCITEMA {
  UINT   mask;
  DWORD  dwState;
  DWORD  dwStateMask;
  LPSTR  pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEMA, *LPTCITEMA;

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_PARAM	Il membro lParam è valido.
TCIF_RTLREADING	La stringa a cui punta pszText verrà visualizzata nella direzione opposta al testo nella finestra padre.
TCIF_STATE	versione 4.70. Il membro dwState è valido.
TCIF_TEXT	Il membro pszText è valido.

dwState

Tipo: DWORD

versione 4.70. Specifica lo stato corrente dell'elemento se le informazioni vengono recuperate. Se vengono impostate informazioni sull'elemento, questo membro contiene il valore di stato da impostare per l'elemento. Per un elenco degli stati validi degli elementi di controllo struttura a schede, vedere Tab Control Item States.For a list of valid tab control item states, see Tab Control Item States. Questo membro viene ignorato nel messaggio di TCM_INSERTITEM.

dwStateMask

Tipo: DWORD

versione 4.70. Specifica i bit del membro dwState contengono informazioni valide. Questo membro viene ignorato nel messaggio di TCM_INSERTITEM.

pszText

Tipo: LPTSTR

Puntatore a una stringa con terminazione Null che contiene il testo della scheda quando 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

Dimensioni nel TCHAR 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 struttura a schede o -1 se non è presente alcuna immagine per la scheda.

lParam

Tipo: LPARAM

Dati definiti dall'applicazione associati all'elemento del controllo struttura a schede. Se esistono più o meno di 4 byte di dati definiti dall'applicazione per scheda, un'applicazione deve definire una struttura e usarla invece della struttura TCITEM. Il primo membro della struttura definita dall'applicazione deve essere una struttura TCITEMHEADER.

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