Clase de CButton

Artículo
04/10/2013

proporciona la funcionalidad de los controles de botón de Windows.

class CButton : public CWnd

Members

Constructores públicos

Name	Descripción
CButton::CButton	Crea un objeto CButton.

Métodos públicos

Name	Descripción
CButton::Create	Hace que el control de botón de Windows y lo asocia al objeto de CButton .
CButton::DrawItem	Reemplazo para dibujar un objeto dibujado por de CButton .
CButton::GetBitmap	Recupera el identificador del mapa de bits establecido previamente con SetBitmap.
CButton::GetButtonStyle	Recupera información sobre el estilo del control de botón.
CButton::GetCheck	Recupera el estado de la comprobación de un control de botón.
CButton::GetCursor	Recupera el identificador de la imagen del cursor establecido previamente con SetCursor.
CButton::GetIcon	Recupera el identificador del icono establecido previamente con SetIcon.
CButton::GetIdealSize	Recupera el tamaño ideal de control button.
CButton::GetImageList	Recupera la lista del control de botón.
CButton::GetNote	Recupera el componente de la nota de control de vínculo de comando actual.
CButton::GetNoteLength	Recupera la longitud del texto de la nota para el control de vínculo de comando actual.
CButton::GetSplitGlyph	Recupera el glifo asociado al control actual de botón de expansión.
CButton::GetSplitImageList	Recupera la lista de imágenes del control actual de botón de expansión.
CButton::GetSplitInfo	Recupera información que define el control actual de botón de expansión.
CButton::GetSplitSize	Recupera el rectángulo delimitador del componente desplegable del control actual de botón de expansión.
CButton::GetSplitStyle	Recupera los estilos de botón de expansión que definen el control actual de botón de expansión.
CButton::GetState	Recupera el estado de activación, el estado de resaltado, y el estado del foco de un control de botón.
CButton::GetTextMargin	Recupera el marcado del texto del control de botón.
CButton::SetBitmap	especifica un mapa de bits que se mostrará en el botón.
CButton::SetButtonStyle	cambia el estilo de un botón.
CButton::SetCheck	Establece el estado de la comprobación de un control de botón.
CButton::SetCursor	Especifica una imagen de cursor que se va a mostrar en el botón.
CButton::SetDropDownState	Establece el estado desplegable del control actual de botón de expansión.
CButton::SetIcon	especifica un icono que se mostrará en el botón.
CButton::SetImageList	Establece la lista del control de botón.
CButton::SetNote	Establece la nota en el control de vínculo de comando actual.
CButton::SetSplitGlyph	Asocia un glifo especificado al control actual de botón de expansión.
CButton::SetSplitImageList	Asocia una lista de imágenes al control actual de botón de expansión.
CButton::SetSplitInfo	Especifica información que define el control actual de botón de expansión.
CButton::SetSplitSize	Establece el rectángulo delimitador del componente desplegable del control actual de botón de expansión.
CButton::SetSplitStyle	Establece el estilo del control actual de botón de expansión.
CButton::SetState	Establece el estado del resaltado de un control de botón.
CButton::SetTextMargin	Establece el marcado del texto del control de botón.

Comentarios

un control de botón es una ventana secundaria pequeña, rectangular que se puede hacer clic por intervalos.Los botones sólo se pueden utilizar o en grupos y pueden ser etiquetados o aparecen sin texto.Un botón cambia normalmente aspecto cuando el usuario hace clic en.

Los botones normales son la casilla, el botón de radio, y el mismo botón.Un objeto de CButton puede ser cualquiera de estos, como estilo de botón especificado en su inicialización por la función miembro de Crear .

Además, la clase de CBitmapButton derivada de CButton admite la creación de los controles de botón etiquetados con imágenes de mapa de bits en lugar de texto.CBitmapButton puede tener mapas de bits independientes para un botón hacia arriba, abajo, que tiene el foco, y estados disabled.

Puede crear un control de botón de una plantilla de cuadro de diálogo o directamente en el código.En ambos casos, llame primero al constructor CButton para construir el objeto de CButton ; llamar a continuación a la función miembro de Crear para crear el control de botón de Windows y para adjuntarlo al objeto de CButton .

la construcción puede ser un proceso de un solo paso en una clase derivada de CButton.Escriba un constructor para la clase derivada y llame a Crear dentro del constructor.

Si desea controlar los mensajes de notificación de Windows enviados por un control button a su elemento primario (normalmente una clase derivada de CDialog), agregue una función miembro de entrada y controlador de mensajes de mapa de mensajes a la clase primaria para cada mensaje.

Cada entrada de mapa de mensajes tiene el formato siguiente:

notificación**(id, memberFxn)deON_**

donde id especifica el identificador de ventana secundaria de control que envía la notificación y memberFxn es el nombre de la función principal del miembro que ha escrito para controlar la notificación.

El prototipo de función del elemento primario es el siguiente:

afx_msg void memberFxn();

Las entradas posibles de mapa de mensajes son los siguientes:

Entrada de asignación	Enviado al elemento primario cuando…
TODOS	El usuario hace clic en un botón.
ON_BN_DOUBLECLICKED	El usuario hace doble clic en un botón.

Si crea un objeto de CButton de un recurso de cuadro de diálogo, el objeto de CButton automáticamente se destruye cuando el usuario cierra el cuadro de diálogo.

Si crea un objeto de CButton dentro de una ventana, puede necesitar destruirla.Si crea el objeto de CButton en la pila mediante la función de nuevo , debe llamar a cancelación en el objeto para destruirlo cuando el usuario cierra el control de botón de Windows.Si crea el objeto de CButton en la pila, o se inserta en el objeto primario del cuadro de diálogo, se destruye automáticamente.