Data.DB.TDataSet.ControlsDisabled
Delphi
function ControlsDisabled: Boolean; inline;
C++
bool __fastcall ControlsDisabled();
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Data.DB.pas Data.DB.hpp |
Data.DB | TDataSet |
Description
Détermine si les contrôles orientés données mettent à jour leur affichage afin de refléter les modifications de l'ensemble de données.
Appelez ControlsDisabled pour établir si l'actualisation de l'affichage des données dans les contrôles orientés données est désactivée. Si ControlsDisabled a la valeur true, les contrôles sont désactivés. ControlsDisabled a la valeur true aussi longtemps que le compteur de références qui dénombre les désactivations de l'ensemble de données a une valeur supérieure à zéro. Ce compteur est incrémenté à chaque appel de la méthode DisableControls et décrémenté quand EnableControls est appelée. Les applications appellent DisableControls pour améliorer les performances et empêcher une actualisation permanente de l'affichage quand une itération automatisée parcourt un grand nombre d'enregistrements d'un ensemble de données.
Dans des applications complexes dont les contrôles peuvent avoir été désactivés par différents processus, utilisez la propriété ControlsDisabled comme moyen de vérifier que chaque appel de DisableControls est bien apparié à un appel de EnableControls. Par exemple :
procedure ReEnableControls (DataSet: TDataSet);
begin
while DataSet.ControlsDisabled do
DataSet.EnableControls;
end;
void __fastcall TForm1::ReEnableControls(TDataSet *DataSet)
{
while (DataSet->ControlsDisabled())
DataSet->EnableControls();
}