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:

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.

Requisiti