Vcl.DBGrids.TDBGridColumns.State

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property State: TDBGridColumnsState read GetState write SetState;

C++

__property TDBGridColumnsState State = {read=GetState, write=SetState, nodefault};

Propriétés

Type Visibilité  Source Unité  Parent
property public
Vcl.DbGrids.pas
Vcl.DBGrids.hpp
Vcl.DBGrids TDBGridColumns

Description

Détermine si les colonnes de la grille de données dépendent des champs de l'ensemble de données.

Si la propriété State a la valeur csDefault, les colonnes de la grille de données sont générées dynamiquement à partir des informations de l'ensemble de données associé à la grille. L'aspect, l'ordre et les autres propriétés des colonnes sont déterminés par les champs de l'ensemble de données. Les modifications faites dans les colonnes sont répercutées dans les champs de l'ensemble de données, et inversement.

Si State a la valeur csCustomized, de nombreuses propriétés des colonnes de la grille de données sont indépendantes de l'ensemble de données associé. Par exemple, le libellé du titre d'une colonne a, par défaut, la valeur de la propriété DisplayLabel du champ associé; mais, si State a la valeur csCustomized, la propriété Caption du titre de la colonne et la propriété DisplayLabel du champ peuvent être modifiées indépendamment l'une de l'autre. En fait, une colonne personnalisée (ou persistante) n'a même pas besoin d'être associée à un champ.

Remarque :  Si l'éditeur de colonne est utilisé pour configurer les colonnes de la grille de données, State prend automatiquement la valeur csCustomized. La modification, à l'exécution, de la propriété State supprime toutes les colonnes existantes.

Voir aussi