CTreeCtrl::GetNextItem

Makale
02/26/2013

Çağrı ağacı almak için bu işlevi görüntüleme öğesi, belirtilen ilişki belirttiği sahip nCode parametresi, to hItem.

HTREEITEM GetNextItem(
   HTREEITEM hItem,
   UINT nCode 
) const;

Parametreler

hItem
Bir ağaç öğesi tutamaç.
nCode
İlişki türünü belirten bir bayrak hItem.Bu bayrak, aşağıdaki değerlerden biri olabilir:
- TVGN_CARETSeçili olan öğeyi alır.
- TVGN_CHILDBelirtilen öğe ilk alt öğesi alır hItem parametresi.
- TVGN_DROPHILITESürükle ve bırak işlemi hedef öğe alır.
- TVGN_FIRSTVISIBLEİlk görülebilen öğeyi alır.
- TVGN_LASTVISIBLEAğaç genişletilmiş son öğesinde alır.Bu ağaç görünümü penceresinde görünür son öğeyi almak değil.
- TVGN_NEXTSonraki kardeş öğe alır.
- TVGN_NEXTVISIBLEBelirtilen öğe izleyen sonraki görülebilen öğeyi alır.
- TVGN_PARENTBelirtilen öğe üst alır.
- TVGN_PREVIOUSÖnceki eşdüzey düğüm öğesini alır.
- TVGN_PREVIOUSVISIBLEBelirtilen öğe önündeki ilk görülebilen öğeyi alır.
- TVGN_ROOTBelirtilen öğe bir parçası olduğu kök öğesinin ilk alt öğesi alır.

Dönüş Değeri

Başarılı olursa bir sonraki öğeye tanıtıcı; Aksi halde null.

Notlar

Bu işlev döner null alınmakta madde ağacının kök düğümü ise.Bu ileti ile birlikte kullanın, örneğin, TVGN_PARENT bir ağaç görünümünün kök düğümü, birinci düzey alt bayrak iletisi verecektir null.

Örnek

Kullanarak örnek için GetNextItem bir döngüde bkz: 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);
}