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

# TCustomListView.OnCustomDrawSubItem

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

## Declaration

Source position: comctrls.pp line 1618

`protected property TCustomListView.OnCustomDrawSubItem : TLVCustomDrawSubItemEvent read FOnCustomDrawSubItem write FOnCustomDrawSubItem;`

## 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.