Vcl.DBCtrls.TDBCheckBox.ValueUnchecked

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property ValueUnchecked: string read FValueUncheck write SetValueUncheck stored IsValueUnchecked nodefault;

C++

__property System::UnicodeString ValueUnchecked = {read=FValueUncheck, write=SetValueUncheck, stored=IsValueUnchecked};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property published
Vcl.DBCtrls.pas
Vcl.DBCtrls.hpp
Vcl.DBCtrls TDBCheckBox

Beschreibung

Gibt den Feldwert an, der von einem markierten Kontrollfeld repräsentiert wird.

Mit der Eigenschaft ValueUnchecked können Sie den Feldwert festlegen, den ein nicht markiertes Kontrollfeld repräsentiert. Wenn der Wert der Eigenschaft ValueUnchecked mit den Daten im Feld des aktuellen Datensatzes übereinstimmt, wird das Datenbank-Kontrollfeld nicht markiert angezeigt. Deaktiviert der Benutzer das Datenbank-Kontrollfeld, wird dem Feld der Wert von ValueUnchecked zugewiesen.

ValueUnchecked kann mehrere Werte in Form einer Liste repräsentieren, deren Einträge durch Strichpunkte getrennt sind. Wenn einer der Listeneinträge mit dem Inhalt des Feldes im aktuellen Datensatz übereinstimmt, wird das Kontrollfeld nicht markiert angezeigt. Sie können ValueUnchecked beispielsweise folgenden String zuweisen:



DBCheckBox1.ValueUnchecked := 'False;No;Off';



DBCheckBox1->ValueUnchecked = "False;No;Off";



Enthält das verknüpfte Feld einen der Strings "Falsch", "Nein" oder "Aus", wird das Kontrollfeld nicht markiert. Der Feldwert wird mit dem Wert von ValueUnchecked verglichen, wobei die Groß-/Kleinschreibung nicht berücksichtigt wird. Wenn ValueUnchecked mehrere Werte enthält und der Benutzer das Kontrollfeld deaktiviert, wird dem Feld der erste Eintrag der Liste zugewiesen.

Wenn das Feld einen der Strings der Eigenschaft ValueChecked enthält, wird das Feld markiert angezeigt. Wenn der Feldinhalt mit keinem der Strings in ValueChecked oder ValueUnchecked übereinstimmt, wird das Kontrollfeld grau dargestellt.

Anmerkung:  Wenn dem Datenbank-Kontrollfeld ein logisches Feld zugeordnet ist, wird das Kontrollfeld immer deaktiviert, wenn der Feldinhalt false ist, und immer aktiviert, wenn der Feldinhalt true ist. Bei logischen Feldern haben die Werte der Eigenschaften ValueChecked und ValueUnchecked also keine Bedeutung.

Siehe auch