Sign in Join
FPDoc Onlineexperiment

TCustomListView.OwnerData property

Member of TCustomListViewpublicIn unit ComCtrls

Enables or disables owner data (virtual) mode for the list view control.

Declaration

pascal
property OwnerData: Boolean read FOwnerData write SetOwnerData default False;

Description

OwnerData is a Boolean property which enables or disables virtual mode for the list view control.

When set to True, the Items property does not contain the actual data displayed on the control. Only the most recently accessed list item exists in the list view control. This allows the list view to be used to display a large number of items with a minimal amount of overhead. List item content is located and retrieved using event handlers in the control.

OnData
Retrieves the content for the selected / focused virtual list item.
OnDataFind
Locates a virtual list item with a specified value.
OnDataHint
Notifies the control when a caching hint for virtual data is received and handled in the control.

Set the value for the Count property in Items to indicate the number of owner data items available to the list view control. Assign a routine to OnData to populate an individual list item (and sub-items if needed) from the source for the owner data.

When OwnerData is set to False, all values displayed on the list view control are maintained in the Items property.

OwnerData is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value.

See also

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