Estructura TCITEMHEADERA (commctrl.h)

  • Artículo

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

Sintaxis

typedef struct tagTCITEMHEADERA {
  UINT  mask;
  UINT  lpReserved1;
  UINT  lpReserved2;
  LPSTR pszText;
  int   cchTextMax;
  int   iImage;
} TCITEMHEADERA, *LPTCITEMHEADERA;

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_RTLREADING
 La cadena a la que apunta pszText se mostrará en la dirección opuesta al texto de la ventana primaria.
TCIF_TEXT
 El miembro pszText es válido.

lpReserved1

Tipo: UINT

Miembro reservado. No debe usarse.

lpReserved2

Tipo: UINT

Miembro reservado. No debe usarse.

pszText

Tipo: LPTSTR

Dirección de una cadena terminada en NULL que contiene el texto de tabulación si 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 del búfer al que apunta el miembro pszText. Si la estructura no recibe información, se omite este miembro.

iImage

Tipo: int

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

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 TCITEMHEADER 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

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