CCheckListBox-Klasse

Artikel
06/10/2015

Stellt die Funktionalität eines Windows-Kontrolllistenfelds bereit.

class CCheckListBox : public CListBox

Mitglieder

Öffentliche Konstruktoren

Name	Beschreibung
CCheckListBox::CCheckListBox	Erstellt ein CCheckListBox-Objekt.

Öffentliche Methoden

Name	Beschreibung
CCheckListBox::Create	Stellt das Windows-Kontrolllistenfeld erstellt und fügt es an den CCheckListBox-Objekt.
CCheckListBox::DrawItem	Aufgerufen vom - Framework ausgelöst, wenn ein visueller Aspekt eines Ownerdrawnlistenfelds ändert.
CCheckListBox::Enable	Aktiviert oder deaktiviert Kontrolllistenfeldelement ein.
CCheckListBox::GetCheck	Ruft den Zustand des Kontrollkästchens eines Elements ab.
CCheckListBox::GetCheckStyle	Ruft das Format der Kontrollkästchen des Steuerelements ab.
CCheckListBox::IsEnabled	Bestimmt, ob ein Element aktiviert ist.
CCheckListBox::MeasureItem	Aufgerufen vom - Framework ausgelöst, wenn ein Listenfeld mit einem Ownerdrawnformat erstellt wird.
CCheckListBox::OnGetCheckPosition	Aufgerufen durch das Framework, um die Position des Kontrollkästchens eines Elements abzurufen.
CCheckListBox::SetCheck	Legt den Status des Kontrollkästchens eines Elements fest.
CCheckListBox::SetCheckStyle	Legt das Format der Kontrollkästchen des Steuerelements fest.

Hinweise

Ein "Kontrolllistenfeld" zeigt eine Liste von Elementen, wie Dateinamen an. Jedes Element in der Liste weist ein Kontrollkästchen daneben, dass der Benutzer überprüfen oder löschen kann.

CCheckListBox ist nur für Ownerdrawn-Steuerelemente, da die Liste mehrere Textzeichenfolgen enthält. Im einfachsten Fall enthält ein Kontrolllistenfeld Textzeichenfolgen und Kontrollkästchen, aber Sie müssen nicht, um Text zu haben vorhanden. Beispielsweise können Sie eine Liste von kleinen Bitmap mit einem Kontrollkästchen neben jedem Element haben.

Um ein eigenes Kontrolllistenfeld zu erstellen, müssen Sie die eigene Klasse von CCheckListBox berechnen. Um eine eigene Klasse ableiten, schreiben Sie einen Konstruktor für die abgeleitete Klasse, und rufen Sie dann Create auf.

Wenn Sie Windows-Benachrichtigungsmeldungen bearbeiten möchten, die durch ein Listenfeld zu seinem übergeordneten Element gesendet werden (normalerweise eine Klasse wird von abgeleitet CDialog-Klasse), fügen Sie eine Meldungszuordnungseintrags- und Meldungshandlermemberfunktion der übergeordneten Klasse für jede Meldung hinzu.

Jeder Eintrag in der Meldungszuordnung weist folgende Form auf:

ON_ Benachrichtigung (id, memberFxn)

wobei id die ID des untergeordneten Fensters sendenden des Steuerelements, ist die Benachrichtigungen und memberFxn der Name der übergeordneten Memberfunktion, die Sie geschrieben haben, um die Benachrichtigung zu bearbeiten.

Der Funktionsprototyp des übergeordneten Elements ist, wie folgt:

afx_msgvoidmemberFxn**( );**

Es gibt nur einen Eintrag in der Meldungszuordnung, der speziell CCheckListBox betrifft (aber finden Sie auch die Meldungszuordnungseinträge für CListBox):

ON_CLBN_CHKCHANGE hat der Benutzer den Status des Kontrollkästchens eines Elements geändert.

Wenn das Kontrolllistenfeld ein Standard Kontrolllistenfeld (eine Liste von Zeichenfolgen mit den Standard-groß Kontrollkästchen auf der linken Seite jedes) ist, können Sie die Standardeinstellung CCheckListBox::DrawItem verwenden, um das Kontrolllistenfeld zu zeichnen. Andernfalls müssen Sie die CListBox::CompareItem-Funktion und die CCheckListBox::DrawItem und CCheckListBox::MeasureItem-Funktionen überschreiben.

Sie können ein Kontrolllistenfeld entweder einer Dialogfeldvorlage oder direkt im Code erstellen.