Struttura TCITEMA (commctrl.h)

Articolo
02/24/2024

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:

Valore	Significato
TCIF_IMAGE	Il membro iImage è valido.
TCIF_PARAM	Il membro lParam è valido.
TCIF_RTLREADING	La stringa puntata da 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 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.

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 di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

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