Pestaña (Controles de Windows)
Esta sección contiene información sobre los elementos de programación usados con controles de pestaña.
Descripciones
Tema | Contenido |
---|---|
Acerca de los controles de pestaña | Un control de tabulación es análogo a los divisores de un cuaderno o las etiquetas de un gabinete de archivos. Mediante un control de pestaña, una aplicación puede definir varias páginas para el mismo área de una ventana o un cuadro de diálogo. |
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 visualizació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 el mensaje TCM_ADJUSTRECT explícitamente. |
TabCtrl_DeleteAllItems | Quita todos los elementos de un control de pestaña. Puede usar esta macro o enviar el mensaje TCM_DELETEALLITEMS explícitamente. |
TabCtrl_DeleteItem | Quita un elemento de un control de pestaña. Puede usar esta macro o enviar el mensaje TCM_DELETEITEM explícitamente. |
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 el mensaje TCM_DESELECTALL explícitamente. |
TabCtrl_GetCurFocus | Devuelve el índice del elemento que tiene el foco en un control de pestaña. Puede usar esta macro o enviar el mensaje TCM_GETCURFOCUS explícitamente. |
TabCtrl_GetCurSel | Determina la pestaña seleccionada actualmente en un control de pestaña. Puede usar esta macro o enviar el mensaje TCM_GETCURSEL explícitamente. |
TabCtrl_GetExtendedStyle | Recupera los estilos extendidos que están actualmente en uso para el control de pestaña. Puede usar esta macro o enviar el mensaje TCM_GETEXTENDEDSTYLE explícitamente. |
TabCtrl_GetImageList | Recupera la lista de imágenes asociada a un control de pestaña. Puede usar esta macro o enviar el mensaje de TCM_GETIMAGELIST explícitamente. |
TabCtrl_GetItem | 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. |
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 tab. Puede usar esta macro o enviar el mensaje TCM_GETITEMRECT explícitamente. |
TabCtrl_GetRowCount | Recupera el número actual de filas de pestañas en 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 pestaña. Puede usar esta macro o enviar el mensaje TCM_GETTOOLTIPS explícitamente. |
TabCtrl_GetUnicodeFormat | Recupera la marca de formato de caracteres UNICODE para el control. Puede usar esta macro o enviar el mensaje de TCM_GETUNICODEFORMAT explícitamente. |
TabCtrl_HighlightItem | Establece el estado de resaltado de un elemento de pestaña. Puede usar esta macro o enviar el mensaje TCM_HIGHLIGHTITEM explícitamente. |
TabCtrl_HitTest | Determina qué pestaña, si existe, está en una posición de pantalla especificada. Puede usar esta macro o enviar el mensaje TCM_HITTEST explícitamente. |
TabCtrl_InsertItem | Inserta una nueva pestaña en un control de pestaña. Puede usar esta macro o enviar el mensaje de TCM_INSERTITEM explícitamente. |
TabCtrl_RemoveImage | Quita una imagen de la lista de imágenes de un control de pestaña. Puede usar esta macro o enviar el mensaje TCM_REMOVEIMAGE explícitamente. |
TabCtrl_SetCurFocus | Establece el foco en una pestaña especificada en un control de pestaña. Puede usar esta macro o enviar el mensaje TCM_SETCURFOCUS explícitamente. |
TabCtrl_SetCurSel | Selecciona una pestaña en un control de pestaña. Puede usar esta macro o enviar el mensaje TCM_SETCURSEL explícitamente. |
TabCtrl_SetExtendedStyle | Establece los estilos extendidos que usará el control de pestaña. Puede usar esta macro o enviar el mensaje TCM_SETEXTENDEDSTYLE explícitamente. |
TabCtrl_SetImageList | Asigna una lista de imágenes a un control de pestaña. Puede usar esta macro o enviar el mensaje de TCM_SETIMAGELIST explícitamente. |
TabCtrl_SetItem | Establece algunos o todos los atributos de una pestaña. Puede usar esta macro o enviar el mensaje TCM_SETITEM explícitamente. |
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ña. Puede usar esta macro o enviar el mensaje TCM_SETITEMEXTRA explícitamente. |
TabCtrl_SetItemSize | Establece el ancho y alto de las pestañas en un control de pestañas dibujado por el propietario o de ancho fijo. Puede usar esta macro o enviar el mensaje de TCM_SETITEMSIZE explícitamente. |
TabCtrl_SetMinTabWidth | Establece el ancho mínimo de elementos de un control de pestaña. Puede usar esta macro o enviar el mensaje TCM_SETMINTABWIDTH explícitamente. |
TabCtrl_SetPadding | Establece la cantidad de espacio (relleno) alrededor del icono y la etiqueta de cada pestaña en un control de pestaña. Puede usar esta macro o enviar el mensaje TCM_SETPADDING explícitamente. |
TabCtrl_SetToolTips | Asigna un control de información sobre herramientas a un control de pestaña. Puede usar esta macro o enviar el mensaje TCM_SETTOOLTIPS explícitamente. |
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 el mensaje TCM_SETUNICODEFORMAT explícitamente. |
Mensajes
Tema | Contenido |
---|---|
TCM_ADJUSTRECT | Calcula el área de visualizació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ña. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_DeleteAllItems. |
TCM_DELETEITEM | Quita un elemento de un control de pestaña. 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 pestaña. 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ña. 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ña. 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ña. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_GetImageList. |
TCM_GETITEM | Recupera información sobre una pestaña en un control de pestaña. 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 tab. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_GetItemRect. |
TCM_GETROWCOUNT | Recupera el número actual de filas de pestañas en 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 pestaña. 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 existe, 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ña. 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ña. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_RemoveImage. |
TCM_SETCURFOCUS | Establece el foco en una pestaña especificada en un control de pestaña. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_SetCurFocus. |
TCM_SETCURSEL | Selecciona una pestaña en un control de pestaña. Puede enviar este mensaje explícitamente o mediante la macro TabCtrl_SetCurSel. |
TCM_SETEXTENDEDSTYLE | Establece los estilos extendidos que usará el control de pestaña. 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ña. 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ña. 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 pestañas 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 elementos de un control de pestaña. 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ña. 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 realizado clic en el botón izquierdo del mouse dentro del control. Este código de notificación se envía en forma de mensaje WM_NOTIFY. |
NM_DBLCLK (pestaña) | Notifica a una ventana primaria de un control de pestaña que el usuario ha haciendo 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 realizado clic en el botón derecho del mouse dentro del control. Este código de notificación se envía en forma de mensaje WM_NOTIFY. |
NM_RDBLCLK (pestaña) | Notifica a la ventana primaria de un control de pestaña que el usuario ha haciendo 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 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 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 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 pestaña en el control. Este código de notificación se envía en forma de mensaje 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 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 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 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 de 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_GETITEMy TCM_SETITEM. Esta estructura reemplaza a la estructura de TC_ITEM. |
TCITEMHEADER | 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. |
Constantes
Tema | Contenido |
---|---|
control de pestañas estilos extendidos | El control de pestaña ahora admite estilos extendidos. Estos estilos se manipulan con los mensajes TCM_GETEXTENDEDSTYLE y TCM_SETEXTENDEDSTYLE y no deben confundirse con los estilos de ventana extendidos que se pasan a CreateWindowEx. |
de 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 estructuraTCITEM admite valores de estado de elemento. |
estilos de control de pestañas de | En esta sección se enumeran los estilos de control de pestaña admitidos. |