TcxCustomListView.GetNextItem(TListItem,TSearchDirection,TItemStates) Method

Searches for the item next to the specified one in the list view.

Declaration

function GetNextItem(StartItem: TListItem; Direction: TSearchDirection; States: TItemStates): TListItem;

Parameters

Name	Type
StartItem	TListItem
Direction	TSearchDirection
States	TItemStates

Returns

Type
TListItem

Remarks

The GetNextItem method searches for the item in the list view, which is located next to the specified one. The following parameters are required:

• The StartItem parameter identifies an item to search from.

• The Direction parameter specifies the search direction. All the possible values of the Direction parameter are listed in the following table:

Value	Meaning
sdLeft	Look to the left of a specified item.
sdRight	Look to the right of a specified item.
sdAbove	Look above a specified item.
sdBelow	Look below a specified item.
sdAll	Look in the order that items appear in the Items property.

• The States parameter – only items in the specified states are considered. Can take the following values:

Value	Meaning
IsNone	Item is in its default state.
isCut	Item is cut (for cut and paste operation).
isDropHilited	Item is highlighted as a drag-and-drop target.
isFocused	Item is focused.
isSelected	Item is selected.
isActivating	Item is active.