HeatmapControl.CustomPaint Event

Occurs after all the heatmap’s visual elements have been drawn.

Namespace: DevExpress.XtraCharts.Heatmap

Assembly: DevExpress.XtraCharts.v24.2.UI.dll

Declaration

C#

public event HeatmapCustomPaintEventHandler CustomPaint

VB.NET

Public Event CustomPaint As HeatmapCustomPaintEventHandler

Event Data

The CustomPaint event's data class is HeatmapCustomPaintEventArgs. The following properties provide information specific to this event:

Property	Description
Bounds	Gets the bounds of a custom graphic object.
DXGraphics	Gets the custom graphic object.

Remarks

Use the CustomPaint event to draw custom graphics over your heatmap.

The following example shows how to handle the CustomPaint event to draw a custom frame on a heatmap surface:

C#

using DevExpress.Drawing;
using DevExpress.XtraCharts.Heatmap;
using System.Drawing;

namespace TestHeatmap {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
            // ...
            heatmapControl1.CustomPaint += heatmapControl1_CustomPaint_1;
        }
        void heatmapControl1_CustomPaint_1(object sender, HeatmapCustomPaintEventArgs e) {
            using(DXPen pen = new DXPen(Color.Red, 2)) {
                e.DXGraphics.DrawRectangle(pen, this.heatmapControl1.Diagram.GetBounds());    
            }
        }
    }
}

VB.NET

Imports DevExpress.Drawing
Imports DevExpress.XtraCharts.Heatmap
Imports System.Drawing

Namespace TestHeatmap
    Partial Public Class Form1
        Inherits Form

        Public Sub New()
            InitializeComponent()
            ' ...
            AddHandler heatmapControl1.CustomPaint, AddressOf heatmapControl1_CustomPaint_1
        End Sub
        Private Sub heatmapControl1_CustomPaint_1(ByVal sender As Object, ByVal e As HeatmapCustomPaintEventArgs)
            Using pen As New DXPen(Color.Red, 2)
                e.DXGraphics.DrawRectangle(pen, Me.heatmapControl1.Diagram.GetBounds())
            End Using
        End Sub
    End Class
End Namespace