Pestaña (controles de Windows)

Esta sección contiene información sobre los elementos de programación usados con controles de pestaña.

Temas de introducción

Tema	Contenido
Acerca de los controles de pestaña	Un control de ficha es análogo a los divisores de un bloc de notas o las etiquetas de un archivador. Mediante el uso de un control de ficha, una aplicación puede definir varias páginas para la misma área de un cuadro de diálogo o de una ventana.
Usar controles de pestaña	Este tema contiene dos ejemplos que usan controles de pestaña.

Macros

Tema	Contenido
TabCtrl_AdjustRect	Calcula el área de presentación de un control de pestaña dada un rectángulo de ventana o calcula el rectángulo de ventana que correspondería a un área de visualización especificada. Puede usar esta macro o enviar explícitamente el mensaje de TCM_ADJUSTRECT .
TabCtrl_DeleteAllItems	Quita todos los elementos de un control de pestañas. Puede usar esta macro o enviar explícitamente el mensaje TCM_DELETEALLITEMS .
TabCtrl_DeleteItem	Quita un elemento de un control de pestañas. Puede usar esta macro o enviar explícitamente el mensaje de TCM_DELETEITEM .
TabCtrl_DeselectAll	Restablece los elementos de un control de pestaña, borrando los que se establecieron en el estado TCIS_BUTTONPRESSED . Puede usar esta macro o enviar explícitamente el mensaje TCM_DESELECTALL .
TabCtrl_GetCurFocus	Devuelve el índice del elemento que tiene el foco en un control de ficha. Puede usar esta macro o enviar explícitamente el mensaje TCM_GETCURFOCUS .
TabCtrl_GetCurSel	Determina la pestaña seleccionada actualmente en un control de pestañas. Puede usar esta macro o enviar explícitamente el mensaje de TCM_GETCURSEL .
TabCtrl_GetExtendedStyle	Recupera los estilos extendidos que están actualmente en uso para el control de pestañas. Puede usar esta macro o enviar explícitamente el mensaje de TCM_GETEXTENDEDSTYLE .
TabCtrl_GetImageList	Recupera la lista de imágenes asociada a un control de pestañas. Puede usar esta macro o enviar explícitamente el mensaje de TCM_GETIMAGELIST .
TabCtrl_GetItem	Recupera información sobre una pestaña de un control de pestañas. Puede usar esta macro o enviar explícitamente el mensaje de TCM_GETITEM .
TabCtrl_GetItemCount	Recupera el número de pestañas del control de pestañas. Puede usar esta macro o enviar el mensaje TCM_GETITEMCOUNT explícitamente.
TabCtrl_GetItemRect	Recupera el rectángulo delimitador de una pestaña de un control de pestañas. Puede usar esta macro o enviar el mensaje TCM_GETITEMRECT explícitamente.
TabCtrl_GetRowCount	Recupera el número actual de filas de pestañas de un control de pestañas. Puede usar esta macro o enviar el mensaje TCM_GETROWCOUNT explícitamente.
TabCtrl_GetToolTips	Recupera el identificador del control de información sobre herramientas asociado a un control de ficha. Puede usar esta macro o enviar explícitamente el mensaje de TCM_GETTOOLTIPS .
TabCtrl_GetUnicodeFormat	Recupera la marca de formato de caracteres UNICODE para el control . Puede usar esta macro o enviar explícitamente el mensaje de TCM_GETUNICODEFORMAT .
TabCtrl_HighlightItem	Establece el estado de resaltado de un elemento de pestaña. Puede usar esta macro o enviar explícitamente el mensaje de TCM_HIGHLIGHTITEM .
TabCtrl_HitTest	Determina qué pestaña, si la hay, está en una posición de pantalla especificada. Puede usar esta macro o enviar explícitamente el mensaje de TCM_HITTEST .
TabCtrl_InsertItem	Inserta una nueva pestaña en un control de pestañas. Puede usar esta macro o enviar explícitamente el mensaje de TCM_INSERTITEM .
TabCtrl_RemoveImage	Quita una imagen de la lista de imágenes de un control de pestañas. Puede usar esta macro o enviar explícitamente el mensaje de TCM_REMOVEIMAGE .
TabCtrl_SetCurFocus	Establece el foco en una pestaña especificada de un control de pestañas. Puede usar esta macro o enviar explícitamente el mensaje de TCM_SETCURFOCUS .
TabCtrl_SetCurSel	Selecciona una pestaña de un control de pestañas. Puede usar esta macro o enviar explícitamente el mensaje de TCM_SETCURSEL .
TabCtrl_SetExtendedStyle	Establece los estilos extendidos que usará el control de ficha. Puede usar esta macro o enviar explícitamente el mensaje de TCM_SETEXTENDEDSTYLE .
TabCtrl_SetImageList	Asigna una lista de imágenes a un control de pestañas. Puede usar esta macro o enviar el mensaje TCM_SETIMAGELIST explícitamente.
TabCtrl_SetItem	Establece algunos o todos los atributos de una pestaña. Puede usar esta macro o enviar explícitamente el mensaje de TCM_SETITEM .
TabCtrl_SetItemExtra	Establece el número de bytes por pestaña reservados para los datos definidos por la aplicación en un control de pestañas. Puede usar esta macro o enviar explícitamente el mensaje TCM_SETITEMEXTRA .
TabCtrl_SetItemSize	Establece el ancho y alto de las pestañas en un control de tabulación dibujado por el propietario o de ancho fijo. Puede usar esta macro o enviar explícitamente el mensaje TCM_SETITEMSIZE .
TabCtrl_SetMinTabWidth	Establece el ancho mínimo de los elementos de un control de pestañas. Puede usar esta macro o enviar explícitamente el mensaje TCM_SETMINTABWIDTH .
TabCtrl_SetPadding	Establece la cantidad de espacio (relleno) alrededor del icono y la etiqueta de cada pestaña en un control de pestañas. Puede usar esta macro o enviar explícitamente el mensaje de TCM_SETPADDING .
TabCtrl_SetToolTips	Asigna un control de información sobre herramientas a un control de pestaña. Puede usar esta macro o enviar explícitamente el mensaje de TCM_SETTOOLTIPS .
TabCtrl_SetUnicodeFormat	Establece la marca de formato de caracteres Unicode para el control. Este mensaje permite cambiar el juego de caracteres usado por el control en tiempo de ejecución en lugar de tener que volver a crear el control. Puede usar esta macro o enviar explícitamente el mensaje de TCM_SETUNICODEFORMAT .

error de Hadoop

Tema	Contenido
TCM_ADJUSTRECT	Calcula el área de presentación de un control de pestaña dada un rectángulo de ventana o calcula el rectángulo de ventana que correspondería a un área de visualización especificada. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_AdjustRect .
TCM_DELETEALLITEMS	Quita todos los elementos de un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_DeleteAllItems .
TCM_DELETEITEM	Quita un elemento de un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_DeleteItem .
TCM_DESELECTALL	Restablece los elementos de un control de pestaña, borrando los que se establecieron en el estado TCIS_BUTTONPRESSED . Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_DeselectAll .
TCM_GETCURFOCUS	Devuelve el índice del elemento que tiene el foco en un control de ficha. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_GetCurFocus .
TCM_GETCURSEL	Determina la pestaña seleccionada actualmente en un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_GetCurSel .
TCM_GETEXTENDEDSTYLE	Recupera los estilos extendidos que están actualmente en uso para el control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_GetExtendedStyle .
TCM_GETIMAGELIST	Recupera la lista de imágenes asociada a un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_GetImageList .
TCM_GETITEM	Recupera información sobre una pestaña de un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_GetItem .
TCM_GETITEMCOUNT	Recupera el número de pestañas del control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_GetItemCount .
TCM_GETITEMRECT	Recupera el rectángulo delimitador de una pestaña de un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_GetItemRect .
TCM_GETROWCOUNT	Recupera el número actual de filas de pestañas de un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_GetRowCount .
TCM_GETTOOLTIPS	Recupera el identificador del control de información sobre herramientas asociado a un control de ficha. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_GetToolTips .
TCM_GETUNICODEFORMAT	Recupera la marca de formato de caracteres Unicode para el control . Puede enviar este mensaje explícitamente o usar la macro TabCtrl_GetUnicodeFormat .
TCM_HIGHLIGHTITEM	Establece el estado de resaltado de un elemento de pestaña. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_HighlightItem .
TCM_HITTEST	Determina qué pestaña, si la hay, está en una posición de pantalla especificada. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_HitTest .
TCM_INSERTITEM	Inserta una nueva pestaña en un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_InsertItem .
TCM_REMOVEIMAGE	Quita una imagen de la lista de imágenes de un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_RemoveImage .
TCM_SETCURFOCUS	Establece el foco en una pestaña especificada de un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_SetCurFocus .
TCM_SETCURSEL	Selecciona una pestaña de un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_SetCurSel .
TCM_SETEXTENDEDSTYLE	Establece los estilos extendidos que usará el control de ficha. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_SetExtendedStyle .
TCM_SETIMAGELIST	Asigna una lista de imágenes a un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_SetImageList .
TCM_SETITEM	Establece algunos o todos los atributos de una pestaña. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_SetItem .
TCM_SETITEMEXTRA	Establece el número de bytes por pestaña reservados para los datos definidos por la aplicación en un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_SetItemExtra .
TCM_SETITEMSIZE	Establece el ancho y alto de las pestañas en un control de tabulación dibujado por el propietario o de ancho fijo. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_SetItemSize .
TCM_SETMINTABWIDTH	Establece el ancho mínimo de los elementos de un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_SetMinTabWidth .
TCM_SETPADDING	Establece la cantidad de espacio (relleno) alrededor del icono y la etiqueta de cada pestaña en un control de pestañas. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_SetPadding .
TCM_SETTOOLTIPS	Asigna un control de información sobre herramientas a un control de pestaña. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_SetToolTips .
TCM_SETUNICODEFORMAT	Establece la marca de formato de caracteres Unicode para el control. Este mensaje permite cambiar el juego de caracteres usado por el control en tiempo de ejecución en lugar de tener que volver a crear el control. Puede enviar este mensaje explícitamente o usar la macro TabCtrl_SetUnicodeFormat .

Notificaciones

Tema	Contenido
NM_CLICK (pestaña)	Notifica a la ventana primaria de un control de pestaña que el usuario ha hecho clic en el botón izquierdo del mouse dentro del control. Este código de notificación se envía en forma de mensaje de WM_NOTIFY .
NM_DBLCLK (pestaña)	Notifica a una ventana primaria de un control de ficha que el usuario ha hecho doble clic en el botón izquierdo del mouse dentro del control. Esta notificación se envía en forma de mensaje de WM_NOTIFY .
NM_RCLICK (pestaña)	Notifica a la ventana primaria de un control de pestaña que el usuario ha hecho clic en el botón derecho del mouse dentro del control. Este código de notificación se envía en forma de mensaje de WM_NOTIFY .
NM_RDBLCLK (pestaña)	Notifica a la ventana primaria de un control de pestaña que el usuario ha hecho doble clic en el botón derecho del mouse dentro del control. Este código de notificación se envía en forma de mensaje de WM_NOTIFY .
NM_RELEASEDCAPTURE (pestaña)	Notifica a la ventana primaria de un control de pestaña que el control está liberando la captura del mouse. Este código de notificación se envía en forma de mensaje de WM_NOTIFY .
TCN_FOCUSCHANGE	Notifica a la ventana primaria de un control de pestaña que el foco del botón ha cambiado. Este código de notificación se envía en forma de mensaje de WM_NOTIFY .
TCN_GETOBJECT	Enviado por un control de pestaña cuando tiene el estilo extendido TCS_EX_REGISTERDROP y un objeto se arrastra sobre un elemento de ficha en el control. Este código de notificación se envía en forma de mensaje de WM_NOTIFY .
TCN_KEYDOWN	Notifica a la ventana primaria de un control de pestaña que se ha presionado una tecla. Este código de notificación se envía en forma de mensaje de WM_NOTIFY .
TCN_SELCHANGE	Notifica a la ventana primaria de un control de pestaña que ha cambiado la pestaña seleccionada actualmente. Este código de notificación se envía en forma de mensaje de WM_NOTIFY .
TCN_SELCHANGING	Notifica a la ventana primaria de un control de pestaña que la pestaña seleccionada está a punto de cambiar. Este código de notificación se envía en forma de mensaje de WM_NOTIFY .

Estructuras

Tema	Contenido
NMTCKEYDOWN	Contiene información sobre una pulsación de tecla en un control de pestaña. Se usa con el código de notificación TCN_KEYDOWN . Esta estructura sustituye a la estructura TC_KEYDOWN .
TCHITTESTINFO	Contiene información sobre una prueba de posicionamiento. Esta estructura sustituye a la estructura TC_HITTESTINFO .
TCITEM	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 .
TCITEMHEADER	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 .

Constantes

Tema	Contenido
Estilos extendidos del control tab	El control de pestaña ahora admite estilos extendidos. Estos estilos se manipulan mediante los mensajes de TCM_GETEXTENDEDSTYLE y TCM_SETEXTENDEDSTYLE y no deben confundirse con los estilos de ventana extendidos que se pasan a CreateWindowEx.
Estados de elemento de control de pestañas	Los elementos de control tab ahora admiten un estado de elemento para admitir el mensaje de TCM_DESELECTALL . Además, la estructura TCITEM admite valores de estado de elemento.
Estilos de control tab	En esta sección se enumeran los estilos de control de pestaña admitidos.