Estructura TCITEMA (commctrl.h)

Especifica o recibe los atributos de un elemento de pestaña. Se usa con los mensajes TCM_INSERTITEM, TCM_GETITEMy TCM_SETITEM. Esta estructura reemplaza a la estructura de 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 de

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

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 de

versión 4.70. Especifica el estado actual del elemento si se recupera información. Si se establece la información del 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 de

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 de

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 del búfer al que apunta el miembro pszText de . 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 de

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 de TCITEM. El primer miembro de la estructura definida por la aplicación debe ser una estructura TCITEMHEADER.

Observaciones

Normalmente, las ventanas muestran texto de izquierda a derecha (LTR). Windows se puede reflejado para mostrar idiomas como hebreo o árabe que leen de derecha a izquierda (RTL). Normalmente, pszText se mostrarán 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de	commctrl.h