TCheckListItem

Die TCheckList Teilhierarchie

Diese Klasse übernimmt die Behandlung der Einträge von TCheckList. Bevor wir eine Instanz von TCheckList erstellen, müssen wir die benötigten Elemente in TCheckListItem definieren, um diese dann an TCheckList übergeben zu können:

int NumItems = 20; ... Items = new TCheckListItem[NumItems]; ... new TCheckList(this, 100, 20, 20, 300, 200, Items, NumItems);

Konstruktoren

TCheckListItem stellt zwei Konstruktoren bereit. Der erste dient der reinen Initialisierung:

TCheckListItem();

Der zweite übernimmt in text den Text und in state den Anfangsstatus des Elements. Als Vorgabewert für den Status wird BF_UNCHECKED verwendet:

TCheckListItem(const char far* text, uint state = BF_UNCHECKED);

Eine Besonderheit stellt der unbestimmte Status eines Elements dar. Im unbestimmten Zustand, wird das Feld in grau mit einer Markierung (BF_GRAYED) angezeigt. Das Element kann aber trotzdem ausgewählt werden.

siehe BF_XXXX Konstanten

Elementfunktionen

void Check();
Das Element ist anfangs markiert.

void GetText(char far* buffer, int len);
Der Text des Elements wird nach buffer kopiert. len enthält die Anzahl der zu kopierenden Zeichen und darf keinen Wert enthalten, der größer ist, als buffer an Zeichen aufnehmen kann.

bool IsChecked() const;
Ist das Element markiert, liefert diese Funktion true zurück, ansonsten false.

bool IsIndeterminate() const;
Ist der Status des Elements unbestimmt (BF_GRAYED), wird true zurückgeliefert.

void SetIndeterminate();
Das Element befindet sich anfangs im unbestimmten Zustand. Wichtig: Besitzt das Element nur zwei Zustände, hat es nach diesem Aufruf 3 Zustände, da SetIndeterminate das Datenelement HasThreeStates auf true setzt!

void SetText(const char far* text);
Setzt den Text des Elements auf die in text angegebene Zeichenfolge.

void SetThreeStates(bool);
Hiermit wird bestimmt, daß das Element drei Zustände besitzt (markiert, nicht markiert, unbestimmt).

void Toggle();
Ändert den Status des Elements. Besitzt dieses zwei Zustände wird bei einem Aufruf von Toggle zwischen markiert und nicht markiert gewechselt. Besitzt das Element hingegen 3 Zustände, erfolgt der Wechsel von nicht markiert über markiert und unbestimmt.

void Uncheck();
Das Element ist nicht markiert.

Übersicht