Vcl.DBCtrls.TDBCheckBox.ValueUnchecked
Delphi
property ValueUnchecked: string read FValueUncheck write SetValueUncheck stored IsValueUnchecked nodefault;
C++
__property System::UnicodeString ValueUnchecked = {read=FValueUncheck, write=SetValueUncheck, stored=IsValueUnchecked};
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 désactivé de la case à cocher.
Utilisez ValueUnchecked pour spécifier la valeur de champ représentée par la case à cocher quand celle-ci est désactivée. Si la valeur de la propriété ValueUnchecked 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 désactivée. Quand l'utilisateur désélectionne la case à cocher de base de données, la valeur ValueUnchecked est affectée au champ.
ValueUnchecked 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 désactivée. Vous pouvez, par exemple, affecter une valeur à la chaîne ValueUnchecked comme suit :
DBCheckBox1.ValueUnchecked := 'Faux;Non;Off';
DBCheckBox1->ValueUnchecked = "Faux;Non;Off";
Si le contenu du champ associé est la chaîne Faux, Non ou Off, la case à cocher apparaît désactivée. La valeur du champ est comparée à ValueUnchecked sans distinction entre majuscules et minuscules. Si l'utilisateur désélectionne une case à cocher pour laquelle ValueUnchecked 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é ValueChecked, la case à cocher apparaît activé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 désactivée si le champ a la valeur false, et elle est toujours activée si le champ a la valeur true. Les valeurs des propriétés ValueChecked et ValueUnchecked n'ont pas d'effet sur les champs logiques.