HeatmapControl.EnableAxisXZooming Property

Specifies whether a user can zoom the heatmap horizontally.

Namespace: DevExpress.XtraCharts.Heatmap

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

Declaration

C#

[DefaultValue(false)]
public bool EnableAxisXZooming { get; set; }

VB.NET

<DefaultValue(False)>
Public Property EnableAxisXZooming As Boolean

Property Value

Type	Default	Description
Boolean	false	true if the heatmap can be zoomed horizontally (along an x-axis); otherwise, false.

Remarks

The following properties allow you to enable navigation in the Heatmap Control:

• EnableAxisXScrolling
• EnableAxisYScrolling
• EnableAxisXZooming
• EnableAxisYZooming

To check whether zoom or scroll operations are available, use the IsScrollingEnabled and IsZoomingEnabled properties.

Use the methods below to zoom and scroll a heatmap programmatically:

• ZoomIn()
• ZoomOut()
• Scroll(HeatmapHorizontalScrollingDirection, HeatmapVerticalScrollingDirection)

Call the HeatmapControl.ResetZoom() method to reset the current zoom state to the default value.

Example

The following code enables zoom and scroll operations in a heatmap:

C#

using DevExpress.XtraCharts.Heatmap;

namespace HeatmapChart {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();

            HeatmapControl heatmap = new HeatmapControl();
            this.Controls.Add(heatmap);
            //...
            heatmap.EnableAxisXScrolling = true;
            heatmap.EnableAxisYScrolling = true;
            heatmap.EnableAxisXZooming = true;
            heatmap.EnableAxisYZooming = true;
        }
    }
}

VB.NET

Imports DevExpress.XtraCharts.Heatmap

Namespace HeatmapChart
    Public Partial Class Form1
        Inherits Form

        Public Sub New()
            InitializeComponent()
            Dim heatmap As HeatmapControl = New HeatmapControl()
            Me.Controls.Add(heatmap)
            '...
            heatmap.EnableAxisXScrolling = True
            heatmap.EnableAxisYScrolling = True
            heatmap.EnableAxisXZooming = True
            heatmap.EnableAxisYZooming = True
        End Sub
    End Class
End Namespace

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the EnableAxisXZooming property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-heatmap-bind-to-data-source/CS/Form1.cs#L60

heatmap.EnableAxisYScrolling = true;
heatmap.EnableAxisXZooming = true;
heatmap.EnableAxisYZooming = true;

winforms-dashboard-custom-items-extension/CS/CustomItemExtension/CustomItems/Heatmap/HeatmapItemControlProvider.cs#L39

heatmap.Legend.Visibility = dashboardItem.Metadata.ShowLegend ? DefaultBoolean.True : DefaultBoolean.False;
heatmap.EnableAxisXZooming = heatmap.EnableAxisXScrolling = dashboardItem.Metadata.EnableZoomingXAxis;
heatmap.EnableAxisYZooming = heatmap.EnableAxisYScrolling = dashboardItem.Metadata.EnableZoomingYAxis;

VB.NET

winforms-heatmap-bind-to-data-source/VB/Form1.vb#L36

Me.heatmap.EnableAxisYScrolling = True
Me.heatmap.EnableAxisXZooming = True
Me.heatmap.EnableAxisYZooming = True

winforms-dashboard-custom-items-extension/VB/CustomItemExtension/CustomItems/Heatmap/HeatmapItemControlProvider.vb#L46

heatmap.EnableAxisXScrolling = dashboardItem.Metadata.EnableZoomingXAxis
heatmap.EnableAxisXZooming = heatmap.EnableAxisXScrolling
heatmap.EnableAxisYScrolling = dashboardItem.Metadata.EnableZoomingYAxis