macro TabCtrl_GetItem (commctrl.h)

Recupera información sobre una pestaña en un control de pestaña. Puede usar esta macro o enviar el mensaje TCM_GETITEM explícitamente.

Sintaxis

BOOL TabCtrl_GetItem(
   HWND     hwnd,
   int      iItem,
   LPTCITEM pitem
);

Parámetros

hwnd

Tipo: HWND

Control para el control de tabulación.

iItem

Tipo: int

Índice de la pestaña.

pitem

Tipo: LPTCITEM de

Puntero a una estructura de TCITEM que especifica la información que se va a recuperar y recibe información sobre la pestaña. Cuando se envía el mensaje, el máscara miembro especifica los atributos que se van a devolver. Si el miembro máscara de especifica el valor TCIF_TEXT, el miembro pszText debe contener la dirección del búfer que recibe el texto del elemento y el miembro cchTextMax debe especificar el tamaño del búfer.

Valor devuelto

Tipo: BOOL de

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario.

Observaciones

Si la marca de TCIF_TEXT está establecida en el miembro del TCITEM estructura, el control puede cambiar el miembro pszText de la estructura para que apunte al nuevo texto en lugar de rellenar el búfer con el texto solicitado. El control puede establecer el miembro pszText en NULL para indicar que no hay texto asociado al elemento.

Requisitos

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