[Overview][Constants][Types][Classes][Procedures and functions][Index] | Reference for unit 'ComCtrls' (#lcl)

# TListItems

[Properties (by Name)] [Methods (by Name)] [Events (by Name)]

TListItems - a list of items with a cache of the last accessed item

## Declaration

Source position: comctrls.pp line 735

`type TListItems = class(TPersistent)`
`protected`
`procedure DefineProperties(); override;` |  | DefineProperties - calls inherited method, then defines some specific binary properties
`function GetCount;` |  | GetCount - find the number of Items in the list
`function GetItem();` |  | GetItem returns the ListItem specified by AIndex
`procedure WSCreateItems;` |  | WSCreateItems - instruction to the Widget Set to create Items
`procedure SetItem();` |  | SetItem - writes the Index and content of a given Item to a local variable
`public`
`function Add;` |  | Add an Item to the Collection
`procedure AddItem();` |  | AddItem - add the specified AItem to the collection
`procedure BeginUpdate;` |  | BeginUpdate - start the update process
`procedure Clear;` |  | Clear - remove all Items from the list
`constructor Create();` |  | Create - constructor for TListItems: calls inherited Create then creates the list
`destructor Destroy; override;` |  | Destroy destructor for TListItems: frees the individual items on the list, then calls inherited Destroy
`procedure Delete();` |  | Remove the Item specified by AIndex from the collection
`procedure EndUpdate;` |  | EndUpdate - finish the update process
`function FindCaption();` |  | FindCaption - returns the ListItem with the specified caption at the given starting place.
`function FindData();` |  | FindData - returns the ListItem associated with the specified datapointer
`function IndexOf();` |  | Returns the IndexOf the Item specified by AItem
`function Insert();` |  | Insert an item in the list at AIndex, returning the value of the ListItem
`procedure InsertItem();` |  | InsertItem - procedure to insert AItem at position AIndex in the list
`property Count: Integer; [r]` |  | Count - the number of items in the collection
`property Item: TListItem; default; [rw]` |  | An Item in the list, specified by its Index value
`property Owner: TCustomListView; [r]` |  | Owner - the ListView that owns this collection of ListItems
`end;`

## Inheritance

`TListItems` |  | TListItems - a list of items with a cache of the last accessed item
`TPersistent`
`TObject`

## Description

TListitems has a built-in cache of the last accessed item. This will speed up interface updates since Item.Index is often used for the same item updating more properties. If FCacheIndex = -1 then the cache is not valid.

The latest version of this document can be found at lazarus-ccr.sourceforge.net.