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.
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. |
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. |
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. |
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 . |
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. |
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. |
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. |