ZoomingOptions.ZoomOutMouseAction Property

Returns the action used to zoom out of the chart.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.dll

NuGet Package: DevExpress.Charts

Declaration

C#

[XtraSerializableProperty(XtraSerializationVisibility.Content)]
public ChartMouseAction ZoomOutMouseAction { get; }

VB.NET

<XtraSerializableProperty(XtraSerializationVisibility.Content)>
Public ReadOnly Property ZoomOutMouseAction As ChartMouseAction

Property Value

Type	Description
ChartMouseAction	The action to zoom out the chart.

Property Paths

You can access this nested property as listed below:

Object Type	Path to ZoomOutMouseAction
Diagram3D	.ZoomingOptions .ZoomOutMouseAction

Remarks

To specify the action used to zoom out of the chart, define the ChartMouseAction.ModifierKeys and ChartMouseAction.MouseButton properties.

Example

This example demonstrates how to change predefined shortcuts and mouse actions that a user can use to zoom in/out the diagram.

Use the following properties to specify the shortcuts:

• ZoomingOptions.ZoomInShortcuts
• ZoomingOptions.ZoomOutShortcuts

The properties below allow you to define the mouse actions:

• ZoomingOptions.ZoomInMouseAction
• ZoomingOptions.ZoomOutMouseAction

C#

using DevExpress.XtraCharts;
using System;
using System.Windows.Forms;
// . . .
private void OnFormLoad(object sender, EventArgs e) {
    XYDiagram xyDiagram = chartControl1.Diagram as XYDiagram;

    // Enable scrolling and zooming for both axes.
    xyDiagram.EnableAxisXZooming = true;
    xyDiagram.EnableAxisYZooming = true;
    xyDiagram.EnableAxisXScrolling = true;
    xyDiagram.EnableAxisYScrolling = true;

    // Click the left mouse button while the Shift key pressed to zoom in to the diagram.
    xyDiagram.ZoomingOptions.ZoomInMouseAction.ModifierKeys = ChartModifierKeys.Shift;
    xyDiagram.ZoomingOptions.ZoomInMouseAction.MouseButton = MouseButtons.Left;

    // Click the left mouse button while the Ctrl key pressed to zoom out of the diagram.
    xyDiagram.ZoomingOptions.ZoomOutMouseAction.ModifierKeys = ChartModifierKeys.Control;
    xyDiagram.ZoomingOptions.ZoomOutMouseAction.MouseButton = MouseButtons.Left;

    // Press Alt + M to zoom in to the diagram.
    xyDiagram.ZoomingOptions.ZoomInShortcuts.Add(Keys.Alt | Keys.M);
    // Press Alt + P to zoom out of the diagram.
    xyDiagram.ZoomingOptions.ZoomOutShortcuts.Add(Keys.Alt | Keys.P);
}

VB.NET

Imports DevExpress.XtraCharts
Imports System
Imports System.Windows.Forms
' . . .
Private Sub OnFormLoad(ByVal sender As Object, ByVal e As EventArgs)
    Dim xyDiagram As XYDiagram = CType(chartControl1.Diagram,XYDiagram)

    ' Enable scrolling and zooming for axes.
    xyDiagram.EnableAxisXZooming = true
    xyDiagram.EnableAxisYZooming = true
    xyDiagram.EnableAxisXScrolling = true
    xyDiagram.EnableAxisYScrolling = true

    ' Click the left mouse button while the Shift key pressed to zoom in to the diagram.
    xyDiagram.ZoomingOptions.ZoomInMouseAction.ModifierKeys = ChartModifierKeys.Shift
    xyDiagram.ZoomingOptions.ZoomInMouseAction.MouseButton = MouseButtons.Left

    ' Click the left mouse button while the Ctrl key pressed to zoom out of the diagram.
    xyDiagram.ZoomingOptions.ZoomOutMouseAction.ModifierKeys = ChartModifierKeys.Control
    xyDiagram.ZoomingOptions.ZoomOutMouseAction.MouseButton = MouseButtons.Left

    ' Press Alt + M to zoom in to the diagram.
    xyDiagram.ZoomingOptions.ZoomInShortcuts.Add((Keys.Alt Or Keys.M))
    ' Press Alt + P to zoom out of the diagram.
    xyDiagram.ZoomingOptions.ZoomOutShortcuts.Add((Keys.Alt Or Keys.P))
End Sub