TreeView_GetItem マクロ (commctrl.h)

  • [アーティクル]

ツリー ビュー 項目の属性の一部またはすべてを取得します。 このマクロを使用することも、TVM_GETITEM メッセージを明示的に送信することもできます。

構文

BOOL TreeView_GetItem(
   HWND     hwnd,
   LPTVITEM pitem
);

パラメーター

hwnd

型: HWND

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

pitem

型: LPTVITEM

取得する情報を指定し、アイテムに関する情報を受け取る TVITEM 構造体へのポインター。 バージョン 4.71 以降では、代わりに TVITEMEX 構造体を使用できます。

戻り値

型: BOOL

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

備考

TVM_GETITEM メッセージが送信されると、TVITEM または TVITEMEX 構造体の hItem メンバーが情報を取得する項目を識別し、マスク メンバーは取得する属性を指定します。

TVIF_TEXT フラグが、TVITEM または TVITEMEX 構造体の マスク メンバー 設定されている場合、pszText メンバーは有効なバッファーを指す必要があり、cchTextMax メンバーはそのバッファー内の文字数に設定する必要があります。 返されたテキストは、必ずしもアプリケーションによって渡された元のバッファーに格納されるとは限りません。 pszText 古いバッファーに配置するのではなく、新しいバッファー内のテキストを指す可能性があります。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー commctrl.h