Botón (controles de Windows)

Artículo
06/13/2023

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.