TreeView_GetItem マクロ (commctrl.h)

  • [アーティクル]

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

構文

void TreeView_GetItem(
   hwnd,
   pitem
);

パラメーター

hwnd

種類: HWND

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

pitem

種類: LPTVITEM

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

戻り値

なし

解説

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

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

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー commctrl.h