CTreeCtrl::GetNextItem

Artikel
02/26/2013

Rufen Sie diese Funktion auf, um das Strukturansichtelement abzurufen, das die angegebene Beziehung verfügt, angegeben durch den nCode-Parameter, zu hItem.

HTREEITEM GetNextItem(
   HTREEITEM hItem,
   UINT nCode 
) const;

Parameter

hItem
Handle eines Strukturelements.
nCode
Ein Flag, das den Typ der Beziehung zu hItem angibt.Dieses Flag kann einer der folgenden Werte sein:
- TVGN_CARET ruft das derzeit ausgewählte Element ab.
- TVGN_CHILD ruft das erste untergeordnete Element des Elements ab, das durch den hItem-Parameter angegeben wird.
- TVGN_DROPHILITE ruft das Element ab, das das Ziel eines Drag & Drop-Vorgangs ist.
- TVGN_FIRSTVISIBLE ruft das erste sichtbare Element ab.
- TVGN_LASTVISIBLE ruft das letzte erweiterte Element in der Struktur ab.Dadurch wird nicht das letzte Element ab, das im Strukturansichtsfenster sichtbar ist.
- TVGN_NEXT ruft das nächste gleichgeordnete Element ab.
- TVGN_NEXTVISIBLE ruft das folgende sichtbares Element ab, das dem angegebenen Element folgt.
- TVGN_PARENT ruft das übergeordnete Element des angegebenen Elements ab.
- TVGN_PREVIOUS ruft das vorhergehende gleichgeordnete Element ab.
- TVGN_PREVIOUSVISIBLE ruft das erste sichtbare Element ab, das dem angegebenen Element vorausgeht.
- TVGN_ROOT ruft das erste untergeordnete Element des Stammelements ab, von dem das angegebene Element ein Teil ist.

Rückgabewert

Das Handle des nächsten Zeitraum, wenn erfolgreich; andernfalls NULL.

Hinweise

Diese Funktion gibt NULL zurück, wenn das Element, das abgerufen wird, der Stammknoten der Struktur ist.Wenn Sie diese Meldung mit dem TVGN_PARENT-Flag auf einem untergeordneten Element der obersten Ebene des Stammknotens der Strukturansicht verwenden, gibt die Meldung NULL zurück.

Beispiel

Ein Beispiel für die Verwendung von GetNextItem in einer Schleife, finden Sie unter 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);
}