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 は空のセットを返します。