Struttura TCITEMW (commctrl.h)

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

Sintassi

typedef struct tagTCITEMW {
  UINT   mask;
  DWORD  dwState;
  DWORD  dwStateMask;
  LPWSTR pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEMW, *LPTCITEMW;

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_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 tab control item states, see Tab Control Item States. Questo membro viene ignorato nel messaggio TCM_INSERTITEM .

dwStateMask

Tipo: DWORD

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

pszText

Tipo: LPTSTR

Puntatore a una stringa con terminazione Null che contiene il testo della scheda quando vengono impostate le informazioni sull'elemento. Se le informazioni sull'elemento vengono recuperate, questo membro specifica l'indirizzo del buffer che riceve il testo della scheda.

cchTextMax

Tipo: int

Dimensioni in TCHARdel 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 oppure -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 anziché la struttura TCITEM . Il primo membro della struttura definita dall'applicazione deve essere una struttura TCITEMHEADER .

In genere, le finestre visualizzano 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, 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

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