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

# TCustomListView.CustomDrawSubItem

Performs custom drawing for the specified sub-item using the event handlers for the control.

## Declaration

Source position: comctrls.pp line 1553

`protected function TCustomListView.CustomDrawSubItem(`
`AItem: TListItem;`
`ASubItem: Integer;`
`AState: TCustomDrawState;`
`AStage: TCustomDrawStage`
`):Boolean; virtual;`

## Arguments

`AItem` |  | List view item with the sub-item drawn in the method.
`ASubItem` |  | Ordinal position for the sub-item drawn in the method.
`AState` |  | Drawing state for the sub-item (selected, focused, disabled, et. al.).
`AStage` |  | Drawing stage for the sub-item. cdPrePaint allows the OnCustomDrawSubItem event handler to be signalled.

## Function result

True if default drawing for the sub-item needs to be performed in the list view control.

## Description

CustomDrawSubItem is a Boolean function used to custom draw a sub-item on the list view control. The OnCustomDrawSubItem and OnAdvancedCustomDrawSubItem event handlers are signalled (when assigned) to perform the drawing operations needed for the item, sub-item, stage, and state arguments.

OnCustomDrawSubItem is signalled when Stage contains cdPrePaint. OnAdvancedCustomDrawSubItem is signalled for any of the values in the TCustomDrawStage enumeration.

CustomDrawSubItem is called from the IntfCustomDraw method.

## See also

TCustomListView.IsCustomDrawn |  | Returns True if a target is custom-drawn in the control.
TCustomListView.OnCustomDrawSubItem |  | Event handler signalled to perform custom drawing for list sub-item on the control.
TCustomListView.OnAdvancedCustomDrawSubItem |  | Event handler signalled to custom draw list sub-items when the draw stage is not cdPrePaint.
TCustomListView.IntfCustomDraw |  | IntfCustomDraw - uses the interface to perform custom drawing
TListItem.SubItems |  | Contains text displayed as additional columns on the list view control.
TCustomDrawStage |  | TCustomDrawStage a series of constants to define the drawing stages for custom-drawn controls.
TCustomDrawState |  | TCustomDrawState - set of TCustomDrawStateFlag.