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 を返します。
次のいずれかの関連マクロを使用することもできます。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| Header |
|