CTreeCtrl::GetNextItem
指定された関係がある hItemに nCode のパラメーターで、という名前のツリー ビュー アイテムを取得するには、この関数を呼び出します。
HTREEITEM GetNextItem(
HTREEITEM hItem,
UINT nCode
) const;
パラメーター
hItem
ツリー項目のハンドル。nCode
hItemに関係の種類を示すフラグ。このフラグは次の値の 1 つです:TVGN_CARET は、現在選択されている項目を取得します。
TVGN_CHILD は hItem パラメーターで指定された項目の最初の子アイテムを取得します。
TVGN_DROPHILITE は、ドラッグ アンド ドロップ操作のターゲットであるアイテムを取得します。
TVGN_FIRSTVISIBLE は最初に表示されるアイテムを取得します。
TVGN_LASTVISIBLE は、ツリーの最後に展開されたアイテムを取得します。これは、ツリー ビュー ペインに表示されている最後の項目を取得しません。
TVGN_NEXT は、次の兄弟アイテムを取得します。
TVGN_NEXTVISIBLE、指定した項目の直後に表示されるアイテムを取得します。
TVGN_PARENT、指定した項目の親を取得します。
TVGN_PREVIOUS は前の兄弟アイテムを取得します。
TVGN_PREVIOUSVISIBLE、指定した項目の前にある最初に表示されるアイテムを取得します。
TVGN_ROOT、指定した項目が一部であるルート アイテムの最初の子アイテムを取得します。
戻り値
成功した場合は、次の項目のハンドル; それ null。
解説
この関数は、取得する項目がツリーのルート ノード null 場合はを返します。たとえば、ツリー ビューのルート ノードの 1 番目のレベルの子 TVGN_PARENT フラグを使用してこのメッセージを使用する場合、メッセージは nullを返します。
使用例
ループの GetNextItem 使用例については、CTreeCtrl::DeleteItemを参照してください。
// find the currently selected item
HTREEITEM hCurSel = m_TreeCtrl.GetNextItem(TVI_ROOT, TVGN_CARET);
// report it to the user
if (hCurSel == NULL)
{
AfxMessageBox(_T("There is no selected item"));
}
else
{
CString str;
str.Format(_T("The currently selected item is \"%s\""),
(LPCTSTR)m_TreeCtrl.GetItemText(hCurSel));
AfxMessageBox((LPCTSTR)str);
}
必要条件
ヘッダー: afxcmn.h