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};
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| property | published | Vcl.DBCtrls.pas Vcl.DBCtrls.hpp |
Vcl.DBCtrls | TDBCheckBox |
Description
Spécifie la valeur de champ qui correspond à l'état activé de la case à cocher.
Utilisez ValueChecked pour spécifier la valeur de champ représentée par la case à cocher quand celle-ci est activée. Si la valeur de la propriété ValueChecked est égale au contenu du champ pour l'enregistrement en cours dans l'ensemble de données, la case à cocher de base de données apparaît activée. Quand l'utilisateur sélectionne la case à cocher de base de données, la valeur ValueChecked est affectée au champ.
ValueChecked peut définir plusieurs valeurs à l'aide d'une liste d'éléments séparés par des points-virgules. Si un de ces éléments correspond au contenu du champ pour l'enregistrement en cours dans l'ensemble de données, la case à cocher apparaît activée. Vous pouvez, par exemple, affecter une valeur à la chaîne ValueChecked comme suit :
DBCheckBox1.ValueChecked := 'Vrai;Oui;On';
DBCheckBox1->ValueChecked = "Vrai;Oui;On";
Si le contenu du champ associé est la chaîne Vrai, Oui ou On, la case à cocher est activée. La valeur du champ est comparée à ValueChecked sans distinction entre majuscules et minuscules. Si l'utilisateur sélectionne une case à cocher pour laquelle ValueChecked définit plusieurs valeurs, la valeur affectée au champ est le premier élément de la liste.
Si le contenu du champ pour l'enregistrement en cours correspond à une chaîne spécifiée en tant que valeur de la propriété ValueUnchecked, la case à cocher apparaît désactivée. Si le contenu du champ ne correspond à aucune chaîne de ValueChecked ou ValueUnchecked, la case à cocher apparaît grisée.
Remarque : Si le DataField de la case à cocher de base de données est un champ logique, la case à cocher est toujours activée si le champ a la valeur true et elle est toujours désactivée si le champ a la valeur false. Les valeurs des propriétés ValueChecked et ValueUnchecked n'ont pas d'effet sur les champs logiques.