Vcl.DBCtrls.TDBCheckBox.ValueChecked
Delphi
property ValueChecked: string read FValueCheck write SetValueCheck stored IsValueChecked nodefault;
C++
__property System::UnicodeString ValueChecked = {read=FValueCheck, write=SetValueCheck, stored=IsValueChecked};
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 ValueChecked können Sie den Feldwert festlegen, den ein markiertes Kontrollfeld repräsentiert. Wenn der Wert der Eigenschaft ValueChecked mit den Daten im Feld des aktuellen Datensatzes übereinstimmt, wird das Datenbank-Kontrollfeld markiert angezeigt. Markiert der Benutzer das Datenbank-Kontrollfeld, wird dem Feld der Wert von ValueChecked zugewiesen.
ValueChecked 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 markiert angezeigt. Sie können ValueChecked beispielsweise folgenden String zuweisen:
DBCheckBox1.ValueChecked = 'Wahr;Ja;Ein';
DBCheckBox1->ValueChecked = "True;Yes;On";
Enthält das verknüpfte Feld einen der Strings "Wahr", "Ja" oder "Ein", wird das Kontrollfeld markiert. Der Feldwert wird mit dem Wert von ValueChecked verglichen, wobei die Groß-/Kleinschreibung nicht berücksichtigt wird. Wenn ValueChecked mehrere Werte enthält und der Benutzer das Kontrollfeld markiert, wird dem Feld der erste Eintrag der Liste zugewiesen.
Wenn das Feld einen der Strings der Eigenschaft ValueUnchecked enthält, wird das Kontrollfeld nicht 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 aktiviert, wenn der Feldinhalt true ist, und immer deaktiviert, wenn der Feldinhalt false ist. Bei logischen Feldern haben die Werte der Eigenschaften ValueChecked und ValueUnchecked also keine Bedeutung.