<< Gesamtübersicht

<< Klassenübersicht

Details der Klasse

Funktionsbeschreibungen

SCheckBox

Ein Kontrollkästchen mit 2 Zuständen. [Mehr ...]

Vererbung

Basisklassen(n)		abgeleitete Klassen
SWindow→ SControl→ SControlPositioned→ SControlPredefined→ SButtonCtrl→	SCheckBox	SCheckBoxTriState

Attribute

protected:

Attribut	Typ	Beschreibung
dependentTyp	SNumList	Liste, syncron zu pDependents, die die Art der Abhängigkeit festlegt. siehe addDependent(..)
offValue	SString	String-Wert wenn die CheckBox deaktiviert ist.
onValue	SString	String-Wert wenn die CheckBox aktiviert ist.
pDependents	SPointerList	Liste mit Zeigern auf SWindow die von Status der SCheckBox abhängig sind. siehe auch dependentTyp

Operationen

public:

Name	Parameter	Rückgabewert	Beschreibung
addDependent	SWindow* pwnd, int typ=0	void	Fügt ein abhängiges Fenster zu dem SCheckBox hinzu.
getState		int	Gibt den aktuellen Zustand zurück.
getStringValue		SString	Liefert den String-Wert der Schaltfläche.
setState	int state	void	Setzt den Zustand des Buttons.
setStateOfDependents		void	Setzt den Status aller abhängigen Fenster. siehe addDependent(..)
setStringValue	const SString& onValue, const SString& offValue	void	Legt die String-Werte der Checkbox fest.
setWindowText	const SString& text	void	Legt den Text fest, der neben der Checkbox angezeigt wird.

protected:

Name	Parameter	Rückgabewert	Beschreibung
onClicked		void	Wird ausgelöst, wenn auf die Checkbox geklickt wurde.
onPostCreateCtrl		void	Wird nach dem Erstellen und vor dem ersten Anzeigen ausgelöst.

Detailbeschreibung SCheckBox

Ein Kontrollkästchen mit 2 Zuständen.

CheckBoxen werden in Programmen in der Regel für Ja/Nein-Entscheidungen wie dem Aktivieren/Deaktivieren bestimmter Funktionalitäten verwendet. Um auf Änderungen der CheckBox zu reagieren wird wie beim Button die Command-Message mit einer Funktion verbunden.

Beispiel: Anlegen einer ChekBox

chkTestBox.createCtrl(this,"TestBox",20,20);
_AddEventCall_OnCommand(chkTestBox.getID(),onChkTestBox)

Zusätzlich können noch abhänige Elemente festgelegt werden. Diese werden mit jeder Statusänderung der CheckBox Aktiviert/Deaktiviert.

chkTestBox.addDependent(&btnTestKnopf);

Funktionsbeschreibungen

addDependent(SWindow* pwnd, int typ=0) void

Fügt ein abhängiges Fenster zu dem SCheckBox hinzu.

Dieses Fenster wird mit jeder Zustandsänderung der CheckBox aktiviert/deaktiviert.

Parameter:

pwnd	Zeiger auf Fenster
typ	Art der Abhängigkeit, eines von: 0 => checked -> enabled 1 => checked -> disabled

getState() int

Gibt den aktuellen Zustand zurück.

Rückgabe:

int	aktueller Zustand: 0 = nicht ausgewählt 1 = ausgewählt 2 = grau/tristate (nur bei SCheckBoxTriState)

getStringValue() SString

Liefert den String-Wert der Schaltfläche.

onClicked() void

Wird ausgelöst, wenn auf die Checkbox geklickt wurde.

onPostCreateCtrl() void

Wird nach dem Erstellen und vor dem ersten Anzeigen ausgelöst.

setState(int state) void

Setzt den Zustand des Buttons.

Parameter:

state

neuer Zustand 0 = nicht ausgewählt 1 = ausgewählt

setStateOfDependents() void

Setzt den Status aller abhängigen Fenster. siehe addDependent(..)

setStringValue(const SString& onValue, const SString& offValue) void

Legt die String-Werte der Checkbox fest.

Parameter:

onValue	Wert wenn Checkbox angehakt ist
offValue	Wert wenn Checkbox nicht angehakt ist

setWindowText(const SString& text) void

Legt den Text fest, der neben der Checkbox angezeigt wird.

Parameter:

text	anzuzeigender Text

<< Gesamtübersicht

<< Klassenübersicht

Details der Klasse

Funktionsbeschreibungen