ListView_GetGroupRect マクロ (commctrl.h)

指定したグループの四角形を取得します。このマクロを使用するか、LVM_GETGROUPRECT メッセージを明示的に送信します。

構文

BOOL ListView_GetGroupRect(
  [in]      HWND hwnd,
  [in]      int  iGroupId,
  [in]      LONG type,
  [in, out] RECT *prc
);

[in] hwnd

型: HWND

リストビューコントロールのハンドル。

[in] iGroupId

型: int

iGroupId グループを指定します (LVGROUP 構造体参照)。

[in] type

型: long

取得する四角形の種類を指定します。このパラメーターは、次のいずれかの値である必要があります。

価値	意味
LVGGR_GROUP	展開されたグループ全体の座標。
LVGGR_HEADER	ヘッダーのみの座標 (折りたたまれたグループ)。
LVGGR_LABEL	ラベルの座標のみ。
LVGGR_SUBSETLINK	サブセットリンクのみの座標 (マークアップサブセット)。リストビューコントロールでは、各グループに表示される表示項目の数を制限できます。ユーザーがグループを展開できるようにするためのリンクがユーザーに表示されます。このフラグは、グループがサブセットの場合、サブセットリンクの外接する四角形を返します (グループの状態LVGS_SUBSETED、LVGROUP構造体、メンバー状態を参照)。このフラグは、アクセシビリティアプリケーションがリンクを見つけられるように提供されます。

[in, out] prc

型: RECT

iGroupIdで指定されたグループに関する情報を受け取る RECT 構造体ポインター。メッセージ受信側は、iGroupIdで指定されたグループの情報を持つ構造体メンバー設定します。呼び出し元のアプリケーションは、構造体にメモリを割り当てる役割を担います。

型: BOOL

成功した場合 TRUE を返し、それ以外の場合は FALSE 返します。