Sign in Join
FPDoc Onlineexperiment

TCustomListView.GetNextItem function

Member of TCustomListViewpublicIn unit ComCtrls

Gets the next list item in the given direction from the starting item.

Declaration

pascal
function GetNextItem(StartItem: TListItem; Direction: TSearchDirection; 
 States: TListItemStates): TListItem

Arguments

StartItem

Initial list item used to find the eligible item.

Direction

Direction of the search for the next list item.

States

Set of states values for eligible list items in the search.

Function result

Next list item in the specified direction.

Description

GetNextItem is a TListItem function used to find the next list item after StartItem in the direction given by the Direction parameter. Only items which include the state values in the States parameter are considered.

GetNextItem calls the corresponding method in the widgetset class instance to get the TListItem which meets the specified search criteria. If no list item is found for the search criteria, the return value is Nil.

Widgetset implementation modified in LCL version 4.4 to call the GetNextSelected method when needed.

See also

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.