CListCtrl::GetNextItem

Suchen nach einem Listenansichtelement, das die angegebenen Eigenschaften verfügt und das die angegebene Beziehung zu einem angegebenen Element enthält.

int GetNextItem(
   int nItem,
   int nFlags 
) const;

Parameter

• nItem
  Index des Elements, um zum Suchen mit zu starten oder -1, um das erste Element zu suchen, der die angegebenen Flags übereinstimmt.Das angegebene Element selbst wird von der Suche ausgeschlossen.

• nFlags
  Geometrische Beziehung des angeforderten Elements zum angegebenen Element und der Zustand des angeforderten Elements.Die geometrische Beziehung kann einer dieser Werte sein:

  • Suchen LVNI_ABOVE für ein Element, das über dem angegebenen Element ist.

  • Suchen LVNI_ALL für ein nachfolgendes Element nach Index (der Standardwert).

  • LVNI_BELOW Suchen eines Elements, das unterhalb des angegebenen Elements ist.

  • Suchen LVNI_TOLEFT für ein Element auf der linken Seite des angegebenen Elements.

  • Suchen LVNI_TORIGHT für ein Element auf der rechten Seite des angegebenen Elements.

• Der Zustand kann null sein, oder es kann eine oder mehrere dieser Werte sein:

  • LVNI_DROPHILITED das Element hat das festgelegte LVIS_DROPHILITED Zustandsflag.

  • LVNI_FOCUSED das Element hat das festgelegte LVIS_FOCUSED Zustandsflag.

  • LVNI_SELECTED das Element hat das festgelegte LVIS_SELECTED Zustandsflag.

  Wenn ein Element nicht alle angegebenen festgelegten Zustandsflags verfügt, wird die Suche mit dem nächsten Element fort.

Rückgabewert

Der Index des nächsten Zeitraum, wenn erfolgreich oder -1; andernfalls.

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CListCtrl-Klasse

Hierarchien-Diagramm

CListCtrl::GetItem