Compartir a través de


CCheckListBox Class

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.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CListBox

CCheckListBox

Requisitos

Encabezado: afxwin.h

Vea también

Referencia

CListBox Class

Gráfico de jerarquías

CListBox Class

Conceptos

ejemplo TSTCON de MFC