CustomDrawColumnHeaderEventArgs.ColumnType Property
Gets a value indicating the type of element to be painted.
Namespace: DevExpress.XtraTreeList
Assembly: DevExpress.XtraTreeList.v24.1.dll
NuGet Packages: DevExpress.Win.Navigation, DevExpress.Win.TreeList
Declaration
Property Value
| Type | Description |
|---|---|
| HitInfoType | A HitInfoType enumeration value indicating the type of element to be painted. |
Available values:
| Name | Description |
|---|---|
| None | A point is outside the Tree List control. |
| Empty | A point is over the empty area. |
| ColumnButton | A point is over the column button. |
| BehindColumn | A point is over the blank column header. |
| Column | A point is over a column header. |
| ColumnEdge | A point is over a column edge. |
| RowIndicator | A point is over a node indicator cell. |
| RowIndicatorEdge | A point is on a row indicator‘s edge. |
| RowIndent | A point is over an area that separates a row from its corresponding indicator cell. This value is returned only when the TreeListOptionsView.ShowIndentAsRowStyle option is enabled. Otherwise, an Empty value is returned when a point is over this area. |
| Row | A point is over a node area not occupied by any of the node’s elements. |
| RowPreview | A point is over a preview section. |
| RowFooter | A point is over a row (group) footer. |
| Cell | A point is over a cell. |
| Button | A point is over an expand button. |
| StateImage | A point is over a node’s state image. |
| SelectImage | A point is over a node’s select image. |
| SummaryFooter | A point is over the summary footer. |
| CustomizationForm | A point is over the Customization Form. |
| VScrollBar | The test point belongs to the Tree List’s vertical scroll bar. |
| HScrollBar | The test point belongs to the Tree List’s horizontal scroll bar. |
| FixedLeftDiv | The test point belongs to the left fixed line. |
| FixedRightDiv | The test point belongs to the right fixed line. |
| NodeCheckBox | The test point belongs to a node’s check box. |
| AutoFilterRow | A point is over the Automatic Filtering Row. |
| FilterPanel | A point is over the Filter Panel. |
| FilterPanelCloseButton | A point is over the Close Filter Button in the Filter Panel. |
| FilterPanelActiveButton | A point is over the check box displayed within in the Filter Panel and used to enable/disable the filter. |
| FilterPanelText | A point is over the filter string displayed within the Filter Panel. |
| FilterPanelMRUButton | A point is over the MRU Filter Button in the Filter Panel. |
| FilterPanelCustomizeButton | A point is over the ‘Edit Filter’ button displayed within the Filter Panel and used to invoke the Filter Editor. |
| ColumnFilterButton | A point is over a Filter Button. |
| ColumnPanel | A point is over a column header panel‘s area not occupied by a column header, blank column header, filter button, column button, or a column edge. |
| Band | A point is over a band header. |
| BandPanel | A point is over the band panel. |
| BandButton | A point is over the band button. |
| BandEdge | A point is over a band edge. |
| Caption | A point is over the Caption Panel. |
| Separator | A point is over a column separator. |
Remarks
The TreeList.CustomDrawColumnHeader event gives you the ability to paint the column header panel using custom draw. You can identify which element is currently painted via the ColumnType property of the event parameter. This property returns the HitInfoType.ColumnButton value when column button painting is performed. If a column header is being painted, it returns the HitInfoType.Column value. The HitInfoType.BehindColumn return value corresponds to the space not occupied by column headers.
You can modify the CustomDrawEventArgs.Handled property of the event parameter with respect to the ColumnType property value. This allows you to perform custom painting of the column button or column headers only.