FireDAC.Comp.DataSet.TFDDataSet.GetGroupState

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function GetGroupState(ALevel: Integer): TGroupPosInds;

C++

Data::Db::TGroupPosInds __fastcall GetGroupState(int ALevel);

Propriétés

Type Visibilité  Source Unité  Parent
function public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet

Description

Indique si l'enregistrement en cours est positionné dans un groupe d'enregistrements spécifié.

Appelez GetGroupState pour déterminer où l'enregistrement en cours se situe dans le groupe d'enregistrements spécifié par le paramètre ALevel. ALevel identifie un groupe par son niveau de regroupement sur l'index en cours. Le regroupement de niveau 1 est l'ensemble des enregistrements ayant la même valeur pour le premier champ de l'index. Le regroupement de niveau 2 est l'ensemble des enregistrements ayant les mêmes valeurs pour les deux premiers champs de l'index, etc. GetGroupState renvoie l'une des valeurs suivantes :

Valeur

Signification

[gbMiddle]

L'enregistrement en cours n'est ni le premier ni le dernier dans le groupe.

[gbFirst]

L'enregistrement en cours est le premier dans le groupe qui contient au moins deux enregistrements.

[gbLast]

L'enregistrement en cours est le dernier dans le groupe qui contient au moins deux enregistrements.

[gbFirstgbLast]

L'enregistrement en cours est le seul enregistrement dans le groupe.

[]

  • ALevel spécifie un niveau de regroupement supérieur à la propriété GroupingLevel.
  • Dataset est dans l'un des états suivants : dsInactive, dsOpening, dsInsert, dsSetKey.
  • AggregatesActive est défini sur False.
  • IndexName est vide.

Voir aussi