Struttura TCITEMA (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 tagTCITEMA {
  UINT   mask;
  DWORD  dwState;
  DWORD  dwStateMask;
  LPSTR  pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEMA, *LPTCITEMA;

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 dello stato da impostare per l'elemento. Per un elenco degli stati dell'elemento di controllo tabulazioni validi, vedere Tab Control Item States. Questo membro viene ignorato nel messaggio di TCM_INSERTITEM .

dwStateMask

Tipo: DWORD

Versione 4.70. Specifica quali 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 contenente il testo della scheda quando 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

Dimensioni in TCHARs 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.

lParam

Tipo: LPARAM

Dati definiti dall'applicazione associati all'elemento di controllo tabulazioni. 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 .

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.

Requisiti