CListCtrl::GetGroupRect
現在のリスト ビュー コントロールの特定のグループの外接する四角形を取得します。
BOOL GetGroupRect(
int iGroupId,
LPRECT lpRect,
int iCoords = LVGGR_GROUP
) const;
パラメーター
パラメーター |
説明 |
|---|---|
[入力] iGroupId |
グループを指定します。 |
[入力、出力] lpRect |
RECT の構造体へのポインター。 このメソッドが成功した場合、構造体は iGroupIdで指定されたグループの四角形の座標を受け取ります。 |
[入力] iCoords |
四角形の座標を取得するように指定します。 これらの値から 1 を使用する:
|
戻り値
このメソッドが成功した場合は true。それ以外の場合は false。
解説
呼び出し元は pRect のパラメーターでを指す RECT の構造を割り当てる必要があります。
このメソッドは Windows SDKで説明する LVM_GETGROUPRECT のメッセージを送信します。
必要条件
ヘッダー: afxcmn.h
このコントロールは Windows Vista 以降でサポートされます。
このメソッドに関するその他の要件については、「Windows Vista コモン コントロールの作成要件」を参照してください。
使用例
次のコード例は、現在のリスト ビュー コントロールへのアクセスに使用される変数、m_listCtrlを定義します。 この変数は次のように使用されます。
public:
// Variable used to access the list control.
CListCtrl m_listCtrl;
GetGroupRect メソッドのコード例を次に示します。 このコード例では、前のセクションでは、表示が 2 列「ClientID」およびレポートのビューの「変換」とよんだリスト ビュー コントロールを作成しました。 次のコード例は、インデックスが 0 でないグループの周囲にこのようなグループが存在する場合、3D の四角形を描画します。
// GetGroupRect
// Get the graphics rectangle that surrounds group 0.
CRect rect;
BOOL bRet = m_listCtrl.GetGroupRect( 0, &rect, LVGGR_GROUP);
// Draw a blue rectangle around group 0.
if (bRet == TRUE) {
m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(0, 0, 255), RGB(0, 0, 255));
}
else {
AfxMessageBox(_T("No group information was retrieved."), MB_ICONINFORMATION);
}