Datasnap.DBClient.TCustomClientDataSet.GetGroupState
Delphi
function GetGroupState(Level: Integer): TGroupPosInds;
C++
Data::Db::TGroupPosInds __fastcall GetGroupState(int Level);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
説明
指定したレコードのグループ内のどこに現在のレコードがあるかを示します。
GetGroupState メソッドを呼び出すと,Level パラメータによって指定されたレコードのグループ内のどこに現在のレコードがあるかを判定できます。
Level は,現在のインデックスのグループ化レベルによってグループを指定します。グループ化レベル 1 は,インデックス内の 1 番めの項目に同じ値を持つレコードのグループです。グループ化レベル 2 は,インデックス内の 1 番めと 2 番めの項目に同じ値を持つレコードのグループです。以降,グループ化レベル 3,4 と続きます。GroupingLevel プロパティより高いグループ化レベルを Level で指定すると,GetGroupState は例外を生成します。
GetGroupState は,現在のレコードが現在のグループ化レベルのどこにあるかを示す値のセットを返します。これは,以下のいずれかの値を持ちます。
値 | 意味 |
---|---|
[gbMiddle] |
現在のレコードは,グループの最初と最後以外にある |
[gbFirst] |
現在のレコードは,2 つ以上のレコードを格納しているグループの最初にある |
[gbLast] |
現在のレコードは,2 つ以上のレコードを格納しているグループの最後にある |
[gbFirst,gbLast] |
現在のレコードは,グループ内の唯一のレコード |
メモ: AggregatesActive が false の場合,または現在のインデックスがグループ化をサポートしていない場合,GetGroupState は空のセットを返します。