CCheckListBox Class

Artículo
06/10/2015

Proporciona la funcionalidad de un cuadro de lista de comprobación de Windows.

class CCheckListBox : public CListBox

Members

Constructores públicos

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

Métodos públicos

Name	Descripción
CCheckListBox::Create	Crea el cuadro de lista de comprobación de Windows y lo asocia al objeto de CCheckListBox .
CCheckListBox::DrawItem	Llamado por el marco cuando un aspecto visual de los cambios de un cuadro de lista de dibujo propietario.
CCheckListBox::Enable	Permisos o neutralizaciones un elemento del cuadro de lista de comprobación.
CCheckListBox::GetCheck	Obtiene el estado de la casilla de un elemento.
CCheckListBox::GetCheckStyle	Obtiene el estilo de las casillas del control.
CCheckListBox::IsEnabled	Determina si un elemento está habilitado.
CCheckListBox::MeasureItem	Llamado por el marco cuando un cuadro de lista con un estilo de dibujo propietario se crea.
CCheckListBox::OnGetCheckPosition	Llamado por el marco para obtener la posición de la casilla de un elemento.
CCheckListBox::SetCheck	Establece el estado de la casilla de un elemento.
CCheckListBox::SetCheckStyle	Establece el estilo de las casillas del control.

Comentarios

Un “cuadro de lista de comprobación” muestra una lista de elementos, como nombres de archivo. Cada elemento de la lista tiene una casilla junto al que el usuario puede comprobar o borrar.

CCheckListBox sólo para los controles propietario- dibujados porque la lista contiene más que las cadenas de texto. En su versión más simple, un cuadro de lista de comprobación contiene las cadenas de texto y las casillas, pero no necesita tener texto en absoluto. Por ejemplo, podría tener una lista de pequeños mapas de bits con una casilla junto a cada elemento.

Para crear su propio cuadro de lista de comprobación, debe derivar su propia clase de CCheckListBox. Para derivar su propia clase, escriba un constructor para la clase derivada, llame a Create.

Si desea controlar los mensajes de notificación de Windows enviados por un cuadro de lista al 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();

Sólo hay una entrada de mensaje- mapa correspondiente específicamente a CCheckListBox (pero vea también las entradas de mensaje- mapa para CListBox):

El usuario deON_CLBN_CHKCHANGE The ha cambiado el estado de la casilla de un elemento.

Si el cuadro de lista de comprobación es cuadro predeterminado de la lista de comprobación (una lista de cadenas con las casillas valor por defecto- ordenadas a la izquierda de cada), puede utilizar el valor predeterminado CCheckListBox::DrawItem para dibujar el cuadro de lista de comprobación. Si no, debe reemplazar la función de CListBox::CompareItem y CCheckListBox::DrawItem y CCheckListBox::MeasureItem funciona.

Puede crear un cuadro de lista de comprobación de una plantilla de cuadro de diálogo o directamente en el código.