TreeList.CustomDrawNodePreview Event
Allows you to custom paint preview sections.
Namespace: DevExpress.XtraTreeList
Assembly: DevExpress.XtraTreeList.v24.2.dll
NuGet Packages: DevExpress.Win.Navigation, DevExpress.Win.TreeList
#Declaration
[DXCategory("CustomDraw")]
public event CustomDrawNodePreviewEventHandler CustomDrawNodePreview
#Event Data
The CustomDrawNodePreview event's data class is CustomDrawNodePreviewEventArgs. The following properties provide information specific to this event:
Property | Description |
---|---|
Appearance | Gets the painted element’s appearance settings. |
Bounds |
Gets the painted element’s bounding rectangle.
Inherited from Custom |
Cache |
Gets an object specifying the storage for the most used pens, fonts and brushes.
Inherited from Custom |
Graphics |
Gets an object used to paint.
Inherited from Custom |
Handled |
Gets or sets a value specifying whether an event was handled and that the default element painting is therefore not required.
Inherited from Custom |
Is |
Gets a value indicating whether the Tree |
Object |
Gets an object containing information about the painted element.
Inherited from Custom |
Painter |
Gets the painter object that provides the default element’s painting mechanism.
Inherited from Custom |
Preview |
Gets or sets the painted preview section’s text. |
Preview |
Gets the content bounds of the preview section. |
The event data class exposes the following methods:
Method | Description |
---|---|
Default |
Performs default painting of an element.
Inherited from Custom |
Draw |
Paints the required HTML template inside an element that raised this event. The context parameter allows you to assign an object that transfers mouse events to template elements.
Inherited from Custom |
Draw |
Paints the required HTML template inside an element that raised this event.
Inherited from Custom |
#Remarks
See the Custom Draw Scenarios topic for information on using custom draw events.
Important
Do not change cell values, modify the control’s layout, or change the control’s object model in the events used for custom control painting. Actions that update the layout can cause the control to malfunction.
#Example
The following sample code handles the TreeList.CustomDrawNodePreview
event. It is used to perform custom painting of preview sections.
The image below displays the result of sample code execution.
using System.Drawing;
using System.Drawing.Drawing2D;
using DevExpress.XtraTreeList
private void treeList1_CustomDrawNodePreview(object sender, CustomDrawNodePreviewEventArgs e) {
// filling background with a linear gradient brush
Brush backBrush = e.Cache.GetGradientBrush(e.Bounds, Color.LightGoldenrodYellow, Color.Cornsilk, LinearGradientMode.Vertical);
e.Cache.FillRectangle(backBrush, e.Bounds);
// painting the preview string
e.Appearance.FontStyleDelta = FontStyle.Italic;
e.Cache.DrawString(e.PreviewText, e.Appearance.Font, Brushes.Maroon, e.Bounds, e.Appearance.GetStringFormat());
// prohibiting default painting
e.Handled = true;
}