次の方法で共有


TVM_GETNEXTITEM メッセージ

指定した項目との関係を持つツリー ビュー項目を取得します。 このメッセージは、 TreeView_GetNextItem マクロを使用して明示的に送信できます。

パラメーター

wParam

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

説明
TVGN_CARET
現在選択されている項目を取得します。 TreeView_GetSelection マクロを使用して、このメッセージを送信できます。
TVGN_CHILD
hitem パラメーターで指定された項目の最初の子項目を取得します。 TreeView_GetChild マクロを使用して、このメッセージを送信できます。
TVGN_DROPHILITE
ドラッグ アンド ドロップ操作のターゲットである項目を取得します。 TreeView_GetDropHilight マクロを使用して、このメッセージを送信できます。
TVGN_FIRSTVISIBLE
ツリー ビュー ウィンドウに表示される最初の項目を取得します。 TreeView_GetFirstVisible マクロを使用して、このメッセージを送信できます。
TVGN_LASTVISIBLE
バージョン 4.71。 ツリー内の最後に展開された項目を取得します。 ツリー ビュー ウィンドウに表示される最後の項目は取得されません。 TreeView_GetLastVisible マクロを使用して、このメッセージを送信できます。
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 マクロを使用して、このメッセージを送信できます。

lParam

アイテムを処理します。

戻り値

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

解説

取得する項目がツリーのルート ノードである場合、このメッセージは NULL を 返します。 たとえば、ツリー ビューのルート ノードの第 1 レベルの子でこのメッセージを TVGN_PARENT フラグと共に使用すると、メッセージは NULL を返します。

次のいずれかの関連マクロを使用することもできます。

TreeView_GetChild
TreeView_GetDropHilight
TreeView_GetFirstVisible
TreeView_GetLastVisible
TreeView_GetNextSibling
TreeView_GetNextVisible
TreeView_GetParent
TreeView_GetPrevSibling
TreeView_GetPrevVisible
TreeView_GetRoot
TreeView_GetSelection

必要条件

要件
サポートされている最小のクライアント
Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2003 [デスクトップ アプリのみ]
Header
Commctrl.h