TCheckBox

Diese Klasse kapselt Markierungsfelder und ist von TButton abgeleitet. Der Benutzer kann das Markierungsfeld mit einer Markierung versehen oder die Markierung aufheben. Zusammengehörende Markierungsfelder werden meistens in einer Gruppe (TGroupBox) zusammengefaßt.

Konstruktor zur direkten Erzeugung

TCheckBox(TWindow* parent, int Id, const char far* title, int x, int y, int w, int h, TGroupBox* group = 0, TModule* module = 0);

Parameter	Bedeutung
parent	Zeiger auf übergeordnetes Fenster.
Id	Dialogelement ID
title	Der im Schalter anzuzeigende Text
x,y	Position der oberen linken Ecke relativ zum Ursprung des Clientbereichs.
w	Breite
h	Höhe
group	Zeiger auf eine assoziierte Gruppe. In der Voreinstellung wird 0 verwendet, was bedeutet, daß das Kontrollelement keiner Gruppe zugeordnet wurde.
module	Zeiger auf die Modul- oder Anwendungsinstanz. Die Voreinstellung ist 0.

Konstruktor zur Erzeugung aus einer Ressource

TCheckBox(TWindow* parent, int resourceId, TGroupBox* group = 0, TModule* module = 0);

Standardattribute

Attr.Style des Markierungsfeldes wird auf WS_CHILD | WS_VISIBLE | WS_TABSTOP | BS_AUTOCHECKBOX gesetzt.

Elementfunktionen

void Check();
Markiert das Markierungsfelds. Das gleiche erreicht man mit einem Aufruf von SetCheck(BF_CHECKED). Wenn es ein assoziiertes Gruppenfeld gibt, wird dieses über die Veränderung benachrichtigt.

uint GetCheck() const;
Liefert den aktuellen Zustand des Markierungsfeldes zurück. Die möglichen Rückgabewerte finden Sie unter BF_XXXX.

TGroupBox* GetGroup() const;
Liefert eine eventuell assoziierte Gruppe zurück.

uint GetState() const;
Liefert Informationen zum Markierungs-, Fokus- und Hervorhebungszustand des Markierungsfelds zurück. Weitere Informationen finden sie unter BM_GETSTATE im Windows SDK.

void SetCheck(uint check);
Ermöglicht den Wechsel des Markierungsfeldes auf einen der bei BF_XXXX aufgeführten Zustände.

void SetGroup(TGroupBox* group);
Hiermit kann das Markierungsfeld noch nachträglich mit einer Gruppe assoziiert werden.

void SetState(uint state);
Setzt den Markierungs-, Fokus- und Hervorhebungszustand. Siehe BM_SETSTATE im Windows SDK.

void SetStyle(uint style, bool redraw);
Ändert den Stil eines Markierungsfelds. Siehe BM_SETSTYLE im Windows SDK

void Toggle();
Schaltet den aktuellen Zustand um. Wenn es sich um ein Markierungsfeld mit drei Zuständen handelt, wird zwischen markiert, demarkiert und grau umgeschaltet.

void Uncheck();
Demarkiert für das Markierungsfeld. Das gleiche erreicht man mit einem Aufruf von SetCheck(BF_UNCHECKED). Wenn es ein assoziiertes Gruppenfeld gibt, wird dieses über die Veränderung benachrichtigt.

Benachrichtigungsbotschaften

Die Benachrichtigungsbotschaften von TCheckBox finden Sie bei der Beschreibung der Klasse TButton.

Beispiel

Ein Beispielprogramm zur Benutzung dieser Klasse finden Sie bei der Beschreibung der Klasse TButton.

Übersicht