Checkbox

Die Checkbox bietet die Möglichkeit, den Benutzer zwischen zwei (oder auch drei) Werten auswählen zu lassen. Sie ist vorwiegend dazu geeignet, bestimmte Optionen ein- oder auszuschalten.

Parameter - Der Parameter, der den Wert dieses Steuerelements zugewiesen bekommt. Der Wert, den der Parameter bekommen kann, wird über die Eigenschaften ValueChecked, ValueGrayed und ValueUnchecked definiert.

Keine zwei Steuerelemente dürfen den selben Parameter zugewiesen bekommen. Sollten doch zwei Elemente den selben Parameter zugewiesen bekommen, wird in den Statusinformationen der Punkt Parameter eindeutig rot markiert. Sollte einem Steuerelement, das die Eigenschaft Parameter besitzt, kein solcher zugeordnet sein, wird der Punkt Parameter zugewiesen rot markiert, um Sie darauf hinzuweisen. Im Kasten Liste der Steuerelemente können Sie die ungültigen Steuerelemente gezielt auswählen.

Alignment - Bei taRightJustify wird der Text der Caption rechtsbündig im Steuerelement angezeigt, bei taLeftJustify linksbündig.

AllowGrayed - Legt fest, ob der Zustand "ausgegraut" erlaubt ist oder nicht.

Hat diese Eigenschaft den Wert false, dann kann die Checkbox entweder markiert oder nicht markiert sein. Durch Einstellen des Wertes true wird ein dritter Zustand möglich: Nebst markiert und nicht markiert ist der Zustand "ausgegraut" möglich, bei dem die Checkbox zwar markiert, aber grau hinterlegt dargestellt wird. Durch Klicken auf die Checkbox wird dann durch die erlaubten Zustände geschaltet.

Anchors - Legt fest, wie sich das Steuerelement bei Größenänderungen des Eingabefensters verhält. Die verankerten Ecken (Anchors) behalten beim Verkleinern oder Vergrößern des Fensters ihre absolute Position bezüglich der Fensterränder bei. Die Eigenschaft Anchors ist dabei eine Menge aus folgenden Werten, die festlegt, welche Seiten verankert sind:

In der Standardeinstellung [akLeft,akTop] behält das Steuerelement immer eine feste Position bezüglich der linken oberen Ecke des Fensters bei. Mit [akRight,akBottom] wäre die Position fix bezüglich der rechten, unteren Ecke. Bei beispielsweise [akLeft,akRight] bleibt der Abstand der linken bzw. rechten Seite des Steuerelements immer gleich zur linken bzw. rechten Seite des Fensters; das bedeutet, bei einer Verbreiterung des Fensters wird auch das Steuerelement breiter und bei einer Verkleinerung wird es ebenfalls kleiner. Durch passendes Setzen der Anchor-Werte bleibt das Layout des Eingabefensters auch bei Größenanpassungen durch den Benutzer erhalten.

Caption - Beschriftung der Checkbox. Ist keine Beschriftung angegeben, wird automatisch der Name des zugewiesenen Parameters als Beschriftung verwendet.

Color - Hintergrundfarbe des Steuerelements.

Font - Schriftart, -eigenschaften, -größe und -farbe, mit denen der Text des Steuerelements angezeigt wird.

Height - Höhe des Steuerelements in Pixeln.

Hint - Text, der als Tool-Tip / Hint angezeigt wird, wenn der Mauszeiger vom Benutzer für längere Zeit auf dem Steuerelement positioniert wird.

Left - Abstand zum linken Fensterrand in Pixeln.

State - Zustand, in dem sich die Checkbox standardmäßig befinden soll (markiert, nicht markiert, ausgegraut).

TabOrder - Legt fest, in welcher Reihenfolge die Steuerelemente im Eingabefenster mittels der Tabulator-Taste durchgeschaltet werden können.

Beim Anzeigen des Eingabefensters bekommt das Steuerelement des Fensters den Eingabefokus, welches den niedrigsten TabOrder-Wert hat. Durch Drücken der Tabulator-Taste wird der Fokus dann auf das Element gewechselt, das den nächst größeren TabOrder-Wert hat. Elemente, die in einer logischen Reihenfolge stehen, sollten aufsteigende TabOrder-Werte zugewiesen bekommen. So kann der Benutzer bequem per Tastendruck durch diese hindurchschalten, ohne die Maus benutzen zu müssen und ohne, dass der Eingabefokus wild hin und her springt. Alle Steuerelemente, außer Text und Grafik, können den Eingabefokus bekommen.

Task - Definiert, ob es sich um eine Pflichteingabe handelt (true) oder ob eine leere Eingabe erlaubt ist (false).

Nur wenn für alle Steuerelemente, deren Eigenschaft Task den Wert true hat, eine Eingabe gemacht wurde, kann das Template ausgeführt werden. Im Fall der Checkbox bedeutet dies, dass diese entweder markiert oder nicht markiert sein muss. Der Zustand "ausgegraut" ist nicht erlaubt.

Top - Abstand zum oberen Fensterrand in Pixeln.

ValueChecked - Der Wert, der dem Parameter zugewiesen wird, wenn die Checkbox markiert ist.

ValueGrayed - Der Wert, der dem Parameter zugewiesen wird, wenn die Checkbox ausgegraut ist. Nur möglich, wenn AllowGrayed den Wert true hat.

ValueUnchecked - Der Wert, der dem Parameter zugewiesen wird, wenn die Checkbox nicht markiert ist.

Width - Breite des Steuerelements in Pixeln.

WordWrap - Schaltet den automatischen Zeilenumbruch ein oder aus.

Bei false wird der Text der Caption in nur einer Zeile dargestellt und abgeschnitten, sollte er über die Breite des Steuerelements hinausgehen. Bei true wird der Text gegebenenfalls wortweise an der Breite umgebrochen und mehrzeilig dargestellt. Von der Höhe her nicht passende Zeilen werden abgeschnitten. Es findet keine automatische Größenanpassung des Steuerelements bezüglich des Textes statt.