CTreeCtrl::GetNextItem
Wywołanie tej funkcji, aby pobrać drzewa wyświetlanie elementu, ma określoną relację, wskazane przez nCode parametr, do hItem.
HTREEITEM GetNextItem(
HTREEITEM hItem,
UINT nCode
) const;
Parametry
hItem
Uchwyt elementu drzewa.nCode
Flagę wskazującą typ relacji, aby hItem.Flaga ta może być jedną z następujących wartości:TVGN_CARETPobiera aktualnie zaznaczonego elementu.
TVGN_CHILDPobiera pierwszy element podrzędny zapasu określonego przez hItem parametru.
TVGN_DROPHILITEPobiera element docelowego operacji przeciągania i upuszczania.
TVGN_FIRSTVISIBLEPobiera pierwszy element widoczny.
TVGN_LASTVISIBLEPobiera ostatni rozwinięty element w drzewie.Nie pobiera ostatni element widoczny w oknie widoku drzewa.
TVGN_NEXTPobiera następny element równorzędny.
TVGN_NEXTVISIBLEPobiera następny element widoczny występujący określonego elementu.
TVGN_PARENTPobiera element nadrzędny określonego elementu.
TVGN_PREVIOUSPobiera poprzedni element równorzędny.
TVGN_PREVIOUSVISIBLEPobiera pierwszy widoczny element, który poprzedza określonego elementu.
TVGN_ROOTPobiera pierwszej pozycji elementu głównego, którego częścią jest określony element podrzędny.
Wartość zwracana
Uchwyt następny element w przypadku powodzenia; w przeciwnym razie NULL.
Uwagi
Funkcja zwróci NULL , jeśli element pobierana jest głównym węzłem drzewa.Na przykład, jeśli używasz tej wiadomości z TVGN_PARENT flagę na dziecko pierwszego poziomu węzła głównego w widoku drzewa, zwróci komunikat NULL.
Przykład
Na przykład za pomocą GetNextItem w pętli, zobacz 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);
}
Wymagania
Nagłówek: afxcmn.h