TVM_GETITEMRECT メッセージ

ツリービューアイテムの外接する四角形を取得し、項目が表示されるかどうかを示します。このメッセージは、明示的に送信することも、 TreeView_GetItemRect マクロを使用して送信することもできます。

パラメーター

wParam: 外接する四角形を取得する項目の部分を指定する値。このパラメーターが TRUE の場合、外接する四角形には項目のテキストのみが含まれます。それ以外の場合は、項目がツリービューコントロール内で占有する行全体が含まれます。
lParam: メッセージを送信するときに、四角形を取得する項目のハンドルを含む RECT 構造体へのポインター。このパラメーターに項目ハンドルを配置する方法の詳細については、次の例を参照してください。メッセージから戻った後、このパラメーターには外接する四角形が含まれます。座標は、ツリービューコントロールの左上隅を基準にしています。

項目が表示され、外接する四角形が正常に取得された場合、戻り値は TRUE になります。それ以外の場合、メッセージは FALSE を 返し、外接する四角形は取得しません。

このメッセージを送信する場合、 lParam パラメーターには、四角形が取得されるアイテムのハンドルが含まれます。次の例に示すように、ハンドルは lParam に配置されます。

RECT rc;

*(HTREEITEM*)&rc = hTreeItem;

SendMessage(hwndTreeView, TVM_GETITEMRECT, FALSE, (LPARAM)&rc);