Datasnap.DBClient.TCustomClientDataSet.GetGroupState

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function GetGroupState(Level: Integer): TGroupPosInds;

C++

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

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Datasnap.DBClient.pas
Datasnap.DBClient.hpp
Datasnap.DBClient TCustomClientDataSet

Beschreibung

Gibt an, wo sich der aktuelle Datensatz in einer angegebenen Datensatzgruppe befindet.

Mit GetGroupState können Sie feststellen, wo sich der aktuelle Datensatz in der Datensatzgruppe befindet, die im Parameter Level angegeben ist.

Level identifiziert eine Gruppe nach ihrer Gruppierungsebene im aktuellen Index. Gruppierungsebene 1 ist die Gruppe der Datensätze mit demselben Wert im ersten Feld des Index. Gruppierungsebene 2 ist die Gruppe der Datensätze mit denselben Werten in den beiden ersten Feldern des Index usw. Wenn Level eine Gruppierungsebene größer als die in der Eigenschaft GroupingLevel angegebene festlegt, löst GetGroupState eine Exception aus.

GetGroupState gibt eine Menge zurück, welche die Position des aktuellen Datensatzes in der aktuellen Gruppierungsebene bezeichnet. Der Typ kann einen der folgenden Werte annehmen:



Wert Bedeutung

[gbMiddle]

Der aktuelle Datensatz ist weder der erste noch der letzte Datensatz in der Gruppe.

[gbFirst]

Der aktuelle Datensatz ist der erste Datensatz in der Gruppe, die mindestens zwei Datensätze enthält.

[gbLast]

Der aktuelle Datensatz ist der letzte Datensatz in der Gruppe, die mindestens zwei Datensätze enthält.

[gbFirst,gbLast]

Der aktuelle Datensatz ist der einzige Datensatz in der Gruppe.



Anmerkung:  Wenn AggregatesActive false ist oder der aktuelle Index keine Gruppierung unterstützt, gibt GetGroupState eine leere Menge zurück.

Siehe auch