Compartir vía


Botón (controles de Windows)

Esta sección contiene información sobre los elementos de programación usados con controles de botón. Un botón es un control que el usuario puede hacer clic para proporcionar la entrada a una aplicación.

Temas de introducción

Tema Contenido
Mensajes de botón En este tema se describen los mensajes que se usan con botones.
Estados del botón En esta sección se describe cómo la selección de un botón cambia su estado y cómo debe responder la aplicación.
Tipos de botón En este tema se describen los diferentes tipos de botones.
Uso de botones En esta sección se explica cómo realizar determinadas tareas asociadas a botones.

Functions

Tema Contenido
CheckDlgButton Cambia el estado de comprobación de un control de botón.
CheckRadioButton Agrega una marca de verificación a (comprueba) un botón de radio especificado en un grupo y quita una marca de verificación de (borra) todos los demás botones de radio del grupo.
IsDlgButtonChecked La función IsDlgButtonChecked determina si se comprueba un control de botón o si un control de botón de tres estados está activado, desmarcado o indeterminado.

Macros

Tema Contenido
Button_Enable Habilita o deshabilita un botón.
Button_GetCheck Obtiene el estado de verificación de un botón de radio o casilla. Puede usar esta macro o enviar el mensaje BM_GETCHECK explícitamente.
Button_GetIdealSize Obtiene el tamaño del botón que mejor se ajusta al texto y a la imagen, si existe una lista de imágenes. Puede usar esta macro o enviar el mensaje BCM_GETIDEALSIZE explícitamente.
Button_GetImageList Obtiene la estructura BUTTON_IMAGELIST que describe la lista de imágenes que se establece para un control de botón. Puede usar esta macro o enviar el mensaje BCM_GETIMAGELIST explícitamente.
Button_GetNote Obtiene el texto de la nota asociada a un botón de vínculo de comando. Puede usar esta macro o enviar el mensaje BCM_GETNOTE explícitamente.
Button_GetNoteLength Obtiene la longitud del texto de la nota que se puede mostrar en la descripción de un vínculo de comando. Use esta macro o envíe explícitamente el mensaje BCM_GETNOTELENGTH .
Button_GetSplitInfo Obtiene información para un control de botón de división especificado. Use esta macro o envíe explícitamente el mensaje BCM_GETSPLITINFO .
Button_GetState Obtiene el estado de verificación de un botón de radio o casilla. Puede usar esta macro o enviar el mensaje BM_GETSTATE explícitamente.
Button_GetText Obtiene el texto de un botón.
Button_GetTextLength Obtiene el número de caracteres del texto de un botón.
Button_GetTextMargin Obtiene los márgenes utilizados para dibujar texto en un control de botón. Puede usar esta macro o enviar el mensaje BCM_GETTEXTMARGIN explícitamente.
Button_SetCheck Establece el estado de verificación de un botón de radio o casilla. Puede usar esta macro o enviar explícitamente el mensaje BM_SETCHECK .
Button_SetDropDownState Establece el estado desplegable de un botón especificado con estilo de BS_SPLITBUTTON. Use esta macro o envíe explícitamente el mensaje BCM_SETDROPDOWNSTATE .
Button_SetElevationRequiredState Establece el estado de elevación necesario para un botón o vínculo de comando especificado para mostrar un icono con privilegios elevados. Use esta macro o envíe explícitamente el mensaje BCM_SETSHIELD .
Button_SetImageList Asigna una lista de imágenes a un control de botón. Puede usar esta macro o enviar el mensaje BCM_SETIMAGELIST explícitamente.
Button_SetNote Establece el texto de la nota asociada a un botón de vínculo de comando especificado. Puede usar esta macro o enviar el mensaje BCM_SETNOTE explícitamente.
Button_SetSplitInfo Establece información para un control de botón de división especificado. Use esta macro o envíe explícitamente el mensaje BCM_SETSPLITINFO .
Button_SetState Establece el estado de resaltado de un botón. El estado de resaltado indica si el botón está resaltado como si el usuario lo hubiera insertado. Puede usar esta macro o enviar el mensaje BM_SETSTATE explícitamente.
Button_SetStyle Establece el estilo de un botón. Puede usar esta macro o enviar el mensaje BM_SETSTYLE explícitamente.
Button_SetText Establece el texto de un botón.
Button_SetTextMargin Establece los márgenes para dibujar texto en un control de botón. Puede usar esta macro o enviar el mensaje BCM_SETTEXTMARGIN explícitamente.

error de Hadoop

Tema Contenido
BCM_GETIDEALSIZE Obtiene el tamaño del botón que mejor se ajusta a su texto e imagen, si existe una lista de imágenes. Puede enviar este mensaje explícitamente o usar la macro Button_GetIdealSize .
BCM_GETIMAGELIST Obtiene la estructura BUTTON_IMAGELIST que describe la lista de imágenes asignada a un control de botón. Puede enviar este mensaje explícitamente o usar la macro Button_GetImageList .
BCM_GETNOTE Obtiene el texto de la nota asociada a un botón de vínculo de comando. Puede enviar este mensaje explícitamente o usar la macro Button_GetNote .
BCM_GETNOTELENGTH Obtiene la longitud del texto de la nota que se puede mostrar en la descripción de un botón de vínculo de comando. Envíe este mensaje explícitamente o mediante la macro Button_GetNoteLength .
BCM_GETSPLITINFO Obtiene información para un control de botón de división. Envíe este mensaje explícitamente o mediante la macro Button_GetSplitInfo .
BCM_GETTEXTMARGIN Obtiene los márgenes utilizados para dibujar texto en un control de botón. Puede enviar este mensaje explícitamente o usar la macro Button_GetTextMargin .
BCM_SETDROPDOWNSTATE Establece el estado desplegable de un botón con estilo TBSTYLE_DROPDOWN. Envíe este mensaje explícitamente o mediante la macro Button_SetDropDownState .
BCM_SETIMAGELIST Asigna una lista de imágenes a un control de botón. Puede enviar este mensaje explícitamente o usar la macro Button_SetImageList .
BCM_SETNOTE Establece el texto de la nota asociada a un botón de vínculo de comando. Puede enviar este mensaje explícitamente o usar la macro Button_SetNote .
BCM_SETSHIELD Establece el estado de elevación necesario para un botón o vínculo de comando especificado para mostrar un icono con privilegios elevados. Envíe este mensaje explícitamente o mediante la macro Button_SetElevationRequiredState .
BCM_SETSPLITINFO Establece información para un control de botón de división. Envíe este mensaje explícitamente o mediante la macro Button_SetSplitInfo .
BCM_SETTEXTMARGIN El mensaje BCM_SETTEXTMARGIN establece los márgenes para dibujar texto en un control de botón.
BM_CLICK Simula que el usuario hace clic en un botón. Este mensaje hace que el botón reciba los mensajes WM_LBUTTONDOWN y WM_LBUTTONUP , y la ventana principal del botón reciba un código de notificación BN_CLICKED .
BM_GETCHECK Obtiene el estado de verificación de un botón de radio o casilla. Puede enviar este mensaje explícitamente o usar la macro Button_GetCheck .
BM_GETIMAGE Recupera un identificador de la imagen (icono o mapa de bits) asociado al botón.
BM_GETSTATE Recupera el estado de un botón o casilla. Puede enviar este mensaje explícitamente o usar la macro Button_GetState .
BM_SETCHECK Establece el estado de verificación de un botón de radio o casilla. Puede enviar este mensaje explícitamente o mediante la macro Button_SetCheck .
BM_SETDONTCLICK Establece una marca en un botón de radio que controla la generación de BN_CLICKED mensajes cuando el botón recibe el foco.
BM_SETIMAGE Asocia una nueva imagen (icono o mapa de bits) con el botón.
BM_SETSTATE Establece el estado de resaltado de un botón. El estado de resaltado indica si el botón está resaltado como si el usuario lo hubiera insertado. Puede enviar este mensaje explícitamente o usar la macro Button_SetState .
BM_SETSTYLE Establece el estilo de un botón. Puede enviar este mensaje explícitamente o usar la macro Button_SetStyle .

Notificaciones

Tema Contenido
BCN_DROPDOWN Se envía cuando el usuario hace clic en una flecha desplegable en un botón. La ventana primaria del control recibe este código de notificación en forma de un mensaje de WM_NOTIFY .
BCN_HOTITEMCHANGE Notifica al propietario del control de botón que el mouse está escribiendo o dejando el área de cliente del control de botón. El control de botón envía este código de notificación en forma de mensaje de WM_NOTIFY .
BN_CLICKED Se envía cuando el usuario hace clic en un botón.
La ventana primaria del botón recibe el código de notificación BN_CLICKED a través del mensaje WM_COMMAND .
BN_DBLCLK Se envía cuando el usuario hace doble clic en un botón. Este código de notificación se envía automáticamente para los botones BS_USERBUTTON, BS_RADIOBUTTON y BS_OWNERDRAW . Otros tipos de botón envían BN_DBLCLK solo si tienen el estilo de BS_NOTIFY .
La ventana primaria del botón recibe el código de notificación BN_DBLCLK a través del mensaje WM_COMMAND .
BN_DISABLE Se envía cuando se deshabilita un botón. Nota: Este código de notificación solo se proporciona por compatibilidad con versiones de 16 bits de Windows anteriores a la versión 3.0. Las aplicaciones deben usar el estilo de botón BS_OWNERDRAW y la estructura DRAWITEMSTRUCT para esta tarea.
La ventana primaria del botón recibe el código de notificación BN_DISABLE a través del mensaje WM_COMMAND .
BN_DOUBLECLICKED Se envía cuando el usuario hace doble clic en un botón. Este código de notificación se envía automáticamente para los botones BS_USERBUTTON, BS_RADIOBUTTON y BS_OWNERDRAW . Otros tipos de botón envían BN_DOUBLECLICKED solo si tienen el estilo de BS_NOTIFY .
La ventana primaria del botón recibe el código de notificación BN_DOUBLECLICKED a través del mensaje WM_COMMAND .
BN_HILITE Se envía cuando el usuario selecciona un botón. Nota: Este código de notificación solo se proporciona por compatibilidad con versiones de 16 bits de Windows anteriores a la versión 3.0. Las aplicaciones deben usar el estilo de botón BS_OWNERDRAW y la estructura DRAWITEMSTRUCT para esta tarea.
La ventana primaria del botón recibe el código de notificación BN_HILITE a través del mensaje WM_COMMAND .
BN_KILLFOCUS Se envía cuando un botón pierde el foco del teclado. El botón debe tener el estilo BS_NOTIFY para enviar este código de notificación.
La ventana primaria del botón recibe el código de notificación BN_KILLFOCUS a través del mensaje WM_COMMAND .
BN_PAINT Se envía cuando se debe pintar un botón. Nota: Este código de notificación solo se proporciona por compatibilidad con versiones de 16 bits de Windows anteriores a la versión 3.0. Las aplicaciones deben usar el estilo de botón BS_OWNERDRAW y la estructura DRAWITEMSTRUCT para esta tarea.
La ventana primaria del botón recibe el código de notificación BN_PAINT a través del mensaje WM_COMMAND .
BN_PUSHED Se envía cuando el estado de inserción de un botón se establece en insertado. Nota: Este código de notificación solo se proporciona por compatibilidad con versiones de 16 bits de Windows anteriores a la versión 3.0. Las aplicaciones deben usar el estilo de botón BS_OWNERDRAW y la estructura DRAWITEMSTRUCT para esta tarea.
La ventana primaria del botón recibe el código de notificación BN_PUSHED a través del mensaje WM_COMMAND .
BN_SETFOCUS Se envía cuando un botón recibe el foco del teclado. El botón debe tener el estilo BS_NOTIFY para enviar este código de notificación.
La ventana primaria del botón recibe el código de notificación BN_SETFOCUS a través del mensaje WM_COMMAND .
BN_UNHILITE Se envía cuando se debe quitar el resaltado de un botón. Nota: Este código de notificación solo se proporciona por compatibilidad con versiones de 16 bits de Windows anteriores a la versión 3.0. Las aplicaciones deben usar el estilo de botón BS_OWNERDRAW y la estructura DRAWITEMSTRUCT para esta tarea.
La ventana primaria del botón recibe el código de notificación BN_UNHILITE a través del mensaje WM_COMMAND .
BN_UNPUSHED Se envía cuando el estado de inserción de un botón está establecido en sin emboscar. Nota: Este código de notificación solo se proporciona por compatibilidad con versiones de 16 bits de Windows anteriores a la versión 3.0. Las aplicaciones deben usar el estilo de botón BS_OWNERDRAW y la estructura DRAWITEMSTRUCT para esta tarea.
La ventana primaria del botón recibe el código de notificación BN_UNPUSHED a través del mensaje WM_COMMAND .
NM_CUSTOMDRAW (botón) Notifica a la ventana primaria de un control de botón sobre las operaciones de dibujo personalizadas en el botón.
El control de botón envía este código de notificación en forma de mensaje de WM_NOTIFY .
WM_CTLCOLORBTN El WM_CTLCOLORBTN mensaje se envía a la ventana primaria de un botón antes de dibujar el botón. La ventana primaria puede cambiar los colores de fondo y texto del botón. Sin embargo, solo los botones dibujados por el propietario responden a la ventana primaria que procesa este mensaje.

Estructuras

Tema Contenido
BUTTON_IMAGELIST Contiene información sobre una lista de imágenes que se usa con un control de botón.
BUTTON_SPLITINFO Contiene información que define un botón de división (BS_SPLITBUTTON y estilos de BS_DEFSPLITBUTTON ). Se usa con los mensajes BCM_GETSPLITINFO y BCM_SETSPLITINFO .
NMBCDROPDOWN Contiene información sobre una notificación de BCN_DROPDOWN .
NMBCHOTITEM Contiene información sobre el movimiento del mouse sobre un control de botón.

Constantes

Tema Contenido
Estilos de botón Especifica una combinación de estilos de botón. Si crea un botón mediante la clase BUTTON con la función CreateWindow o CreateWindowEx , puede especificar cualquiera de los estilos de botón que se enumeran a continuación.