4D Doc Center : Kontrollkästchen

Home

4D v14.3

Kontrollkästchen

Verwendung

Ein Kontrollkästchen wird zur Eingabe oder Anzeige binärer Daten verwendet, wie z.B. Wahr/Falsch. Es ist eine Art Schaltfläche, die entweder aktiviert oder deaktiviert ist. Das Verhalten eines Kontrollkästchens wird durch eine Methode gesteuert. Wie alle Schaltflächen wird ein Kontrollkästchen auf 0 gesetzt, wenn das Formular zum ersten Mal geöffnet wird. Die zugeordnete Methode wird ausgeführt, wenn das Kontrollkästchen markiert wird.
Ein Kontrollkästchen zeigt neben dem Kästchen Text an. Der Text wird in der Eigenschaftenliste unter der Gruppe „Objekte“ definiert. Hier können Sie auch eine XLIFF- oder STR#-Referenz eingeben. Weitere Informationen dazu finden Sie im Abschnitt Kontrollkästchen.

Klickt der Benutzer auf das Kontrollkästchen, wird es markiert. Ist es aktiviert, hat es den Wert 1, ist es nicht nicht aktiviert, hat es den Wert 0.
Sie können Kontrollkästchen auch eine Variable vom Typ Boolean zuweisen. In diesem Fall ist die Variable wahr, wenn das Kästchen markiert ist und falsch, wenn es nicht markiert ist.
Jedes Kontrollkästchen in einem Formular hat einen dieser Zustände:

Bei einer Gruppe kann der Benutzer mehrere Optionen auswählen.

Im Unterschied zu einem Booleschen Datenfeld, das als Kontrollkästchen formatiert ist, werden die Werte der Variablen für das Kontrollkästchen nicht automatisch gespeichert. Zum Verwalten der Variablen verwenden Sie eine Methode.

Hinweis: 3D Kontrollkästchen funktionieren auf dieselbe Art wie Kontrollkästchen. Ihre Darstellung hingegen, also z.B der Status markiert/nicht markiert, wird über die Eigenschaften der 3D Schaltflächenfamilie definiert. Weitere Informationen dazu finden Sie im Abschnitt 3D Schaltflächen, 3D Kontrollkästchen, 3D Optionsfelder.

Kontrollkästchen mit drei Zuständen

Objekte vom Typ Kontrollkästchen lassen einen 3. Status zu. Das ist ein Zusatzstatus, der in der Regel für die Anzeige verwendet wird. Damit können Sie z.B. einzelnen Objekten eine bestimmte Eigenschaft zuweisen, die nicht für alle Objekte gelten soll.

Damit ein Kontrollkästchen diesen 3. Status steuert, müssen Sie in der Eigenschaftenliste unter dem Thema “Anzeige” die Eigenschaft Drei Zustände aktivieren:

Diese Eigenschaft ist nur für standardmäßige Kontrollkästchen mit numerischen Variablen möglich – Kontrollkästchen vom Typ 3D oder für Boolean Felder können diese Eigenschaft nicht verwenden. Ein Feld vom Typ Boolean lässt keinen 3. Zustand zu.
Die dem Kontrollkästchen zugeordnete Variable gibt den Wert 2 zurück, wenn der 3. Zustand vorliegt.

Tipp: Kontrollkästchen mit drei Zuständen zeigen jeden Status sequentiell in folgender Zeilenfolge an: nicht-markiert/ markiert/ alternativ/ nicht-markiert, etc. Der 3. Zustand ist im Eingabemodus in der Regel nicht sinnvoll; setzen Sie deshalb im Code die Variable auf 0 (Null), wenn sie den Wert 2 annimmt, um direkt vom Status markiert in den Status nicht-markiert zu gelangen.