CCheckListBox::Create

Stellt das Windows-Kontrolllistenfeld erstellt und fügt es an den CCheckListBox-Objekt.

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

Parameter

  • dwStyle
    Gibt das Format des Kontrolllistenfelds an.Das Format muss LBS_HASSTRINGS sein und entweder LBS_OWNERDRAWFIXED (alle Elemente in der Liste sind auf die gleiche Höhe) oder LBS_OWNERDRAWVARIABLE (Elemente in der Liste sind unterschiedlicher Höhe).Dieses Format kann mit anderen Listenfeldformate außer LBS_USETABSTOPS kombiniert werden.

  • rect
    Gibt die Kontrolllistenfeldgröße und Position an.Mit kann entweder ein CRect-Objekt oder eine Struktur RECT.

  • pParentWnd
    Gibt das übergeordnete Fenster des Kontrolllistenfelds an (normalerweise ein CDialog-Objekt).Er darf nicht NULL sein.

  • nID
    Gibt die ID des Steuerelements Kontrolllistenfelds an

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.

Hinweise

Sie erstellen ein CCheckListBox-Objekt in zwei Schritten.Zuerst definieren Sie eine Klasse, die von CcheckListBox berechnet wird und dann Create auf, die das Windows-Kontrolllistenfeld initialisiert und an CCheckListBox angefügt werden.Siehe CCheckListBox::CCheckListBox für ein Beispiel.

Wenn Create ausführt, sendet Windows die WM_NCCREATE, WM_CREATE, WM_NCCALCSIZE und WM_GETMINMAXINFO Meldungen zum Kontrolllistenfeldsteuerelement.

Diese Meldungen werden standardmäßig durch die OnNcCreate, OnCreate, OnNcCalcSize und OnGetMinMaxInfo-Memberfunktionen in der CWnd Basisklasse bearbeitet.Um die standardmäßige Meldungsbehandlung zu erweitern, fügen Sie eine Meldungszuordnung der der abgeleiteten Klasse hinzu und überschreiben Sie die vorherigen Meldungshandlermemberfunktionen.Überschreiben Sie OnCreate um beispielsweise erforderliche Initialisierung für eine neue Klasse auszuführen.

Übernehmen Sie folgenden Fensterstile auf ein Kontrolllistenfeldsteuerelement zu:

  • WS_CHILD immer

  • WS_VISIBLE normalerweise

  • WS_DISABLED selten

  • WS_VSCROLL, um eine vertikale Bildlaufleiste hinzuzufügen

  • WS_HSCROLL, um einer horizontalen Bildlaufleiste hinzuzufügen

  • WS_GROUP für Group-Steuerelemente

  • WS_TABSTOP, um das Drücken der TAB-TASTE zu diesem Steuerelement zu ermöglichen

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CCheckListBox-Klasse

Hierarchien-Diagramm

CCheckListBox::CCheckListBox