TCustomListView.OnCustomDrawSubItem

Event handler signalled to perform custom drawing for list sub-item on the control.

Declaration

Source position: comctrls.pp line 1608

Description

OnCustomDrawSubItem is a TLVCustomDrawSubItemEvent property with the event handler used to perform custom drawing for sub-items on a list view control. These are the values found in the SubItems property for each of the TListItem entries on the control.

OnCustomDrawSubItem is signalled (when assigned) from the CustomDrawSubItem method when the drawing stage is cdPrePaint, and occurs when the IntfCustomDraw method handles callbacks from the widgetset class instance.

Arguments to the event handler include:

Sender

The list view control.

Item

The list item with values drawn in the handler.

SubItem

The ordinal position for the sub-item in Item.

State

The draw state for the value.

DefaultDraw

Variable parameter which indicates whether default drawing is handled in the list view control.

Use OnAdvancedCustomDrawSubItem to perform custom drawing for list sub-items when the drawing stage is a value other than cdPrePaint.

Custom drawing event handlers are used when the IntfCustomDraw method handles callbacks from the widgetset class instance.

Use OnCustomDraw and OnAdvancedCustomDraw to perform custom drawing for the entire list view control.

Use OnCustomDrawItem and OnAdvancedCustomDrawItem to perform custom drawing for the a list item on the list view control.