Compartir a través de

Estructura TCITEMHEADERA (commctrl.h)

  • Artículo

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

Sintaxis

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

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_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 de

Miembro reservado. No use.

lpReserved2

Tipo: UINT de

Miembro reservado. No use.

pszText

Tipo: LPTSTR de

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

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

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