次の方法で共有

TreeView_GetNextItem マクロ (commctrl.h)

  • [アーティクル]

指定した項目に対して指定したリレーションシップを持つツリー ビュー項目を取得します。 このマクロを使用するか、以下で説明する TreeView_Get マクロのいずれかを使用するか、TVM_GETNEXTITEM メッセージを明示的に送信できます。

構文

HTREEITEM TreeView_GetNextItem(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

パラメーター

hwnd

型: HWND

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

hitem

型: HTREEITEM

アイテムへのハンドル。

code

型: UINT

取得する項目を指定するフラグ。 このパラメーターには、次のいずれかの値を指定できます。

価値 意味
TVGN_CARET
 現在選択されている項目を取得します。 TreeView_GetSelection マクロを使用して、このメッセージを送信できます。
TVGN_CHILD
 hitem パラメーターで指定された項目の最初の子項目を取得します。 TreeView_GetChild マクロを使用して、このメッセージを送信できます。
TVGN_DROPHILITE
 ドラッグ アンド ドロップ操作の対象となる項目を取得します。 TreeView_GetDropHilight マクロを使用して、このメッセージを送信できます。
TVGN_FIRSTVISIBLE
 最初に表示される項目を取得します。 TreeView_GetFirstVisible マクロを使用して、このメッセージを送信できます。
TVGN_NEXT
 次の兄弟項目を取得します。 TreeView_GetNextSibling マクロを使用して、このメッセージを送信できます。
TVGN_NEXTSELECTED
 Windows Vista 以降。 次に選択した項目を取得します。 TreeView_GetNextSelected マクロを使用して、このメッセージを送信できます。
TVGN_NEXTVISIBLE
 指定した項目の後に表示される次の項目を取得します。 指定した項目が表示されている必要があります。 TVM_GETITEMRECT メッセージを使用して、項目が表示されているかどうかを確認します。 TreeView_GetNextVisible マクロを使用して、このメッセージを送信できます。
TVGN_PARENT
 指定した項目の親を取得します。 TreeView_GetParent マクロを使用して、このメッセージを送信できます。
TVGN_PREVIOUS
 前の兄弟項目を取得します。 TreeView_GetPrevSibling マクロを使用して、このメッセージを送信できます。
TVGN_PREVIOUSVISIBLE
 指定した項目の前に表示される最初の項目を取得します。 指定した項目が表示されている必要があります。 TVM_GETITEMRECT メッセージを使用して、項目が表示されているかどうかを確認します。 TreeView_GetPrevVisible マクロを使用して、このメッセージを送信できます。
TVGN_ROOT
 ツリー ビュー コントロールの最上位または最初の項目を取得します。 TreeView_GetRoot マクロを使用して、このメッセージを送信できます。

戻り値

型: HTREEITEM

成功した場合は、項目へのハンドルを返します。 ほとんどの場合、メッセージはエラーを示す NULL 値を返します。 詳細については、「解説」セクションを参照してください。

備考

このマクロは、取得する項目がツリーのルート ノードである場合、NULL を返します。 たとえば、ツリー ビューのルート ノードの第 1 レベルの子でTVGN_PARENT フラグを指定してこのマクロを使用すると、マクロは null返します。

必要条件

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