Estructura TCITEMA (commctrl.h)

Especifica o recibe los atributos de un elemento de pestaña. Se usa con los mensajes TCM_INSERTITEM, TCM_GETITEM y TCM_SETITEM . Esta estructura sustituye a la estructura TC_ITEM .

Sintaxis

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

Miembros

mask

Tipo: UINT

Valor que especifica qué miembros se van a recuperar o establecer. Este miembro puede ser una combinación de los valores siguientes:

Valor	Significado
TCIF_IMAGE	El miembro iImage es válido.
TCIF_PARAM	El miembro lParam es válido.
TCIF_RTLREADING	La cadena a la que apunta pszText se mostrará en la dirección opuesta al texto de la ventana primaria.
TCIF_STATE	Versión 4.70. El miembro dwState es válido.
TCIF_TEXT	El miembro pszText es válido.

dwState

Tipo: DWORD

Versión 4.70. Especifica el estado actual del elemento si se recupera información. Si se establece información de elemento, este miembro contiene el valor de estado que se va a establecer para el elemento. Para obtener una lista de los estados válidos de los elementos de control de pestañas, vea Estados de elementos de control de pestañas. Este miembro se omite en el mensaje TCM_INSERTITEM .

dwStateMask

Tipo: DWORD

Versión 4.70. Especifica qué bits del miembro dwState contienen información válida. Este miembro se omite en el mensaje TCM_INSERTITEM .

pszText

Tipo: LPTSTR

Puntero a una cadena terminada en null que contiene el texto de tabulación cuando se establece la información del elemento. Si se recupera la información del elemento, este miembro especifica la dirección del búfer que recibe el texto de tabulación.

cchTextMax

Tipo: int

Tamaño en TCHARs del búfer al que apunta el miembro pszText . Si la estructura no recibe información, se omite este miembro.

iImage

Tipo: int

Indexe en la lista de imágenes del control de pestaña o -1 si no hay ninguna imagen para la pestaña.

lParam

Tipo: LPARAM

Datos definidos por la aplicación asociados al elemento de control de pestaña. Si existen más o menos de 4 bytes de datos definidos por la aplicación por pestaña, una aplicación debe definir una estructura y usarla en lugar de la estructura TCITEM . El primer miembro de la estructura definida por la aplicación debe ser una estructura TCITEMHEADER .

Comentarios

Normalmente, las ventanas muestran texto de izquierda a derecha (LTR). Windows se puede reflejar para mostrar idiomas como hebreo o árabe que leen de derecha a izquierda (RTL). Normalmente, pszText se mostrará en la misma dirección que el texto en su ventana primaria. Si se establece TCIF_RTLREADING, pszText leerá en la dirección opuesta del texto de la ventana primaria.

Nota

El encabezado commctrl.h define TCITEM como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	commctrl.h