TreeView_GetNextItem マクロ (commctrl.h)

  • [アーティクル]

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

構文

void TreeView_GetNextItem(
   hwnd,
   hitem,
   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 マクロを使用して、このメッセージを送信できます。

戻り値

なし

解説

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

要件

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