ZoomingOptions.ZoomInShortcuts Property

Returns the collection of keyboard shortcuts that allow end users to zoom in to the chart.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v18.2.dll

Declaration

C#

[XtraSerializableProperty]
public ChartShortcutKeyCollection ZoomInShortcuts { get; }

VB.NET

<XtraSerializableProperty>
Public ReadOnly Property ZoomInShortcuts As ChartShortcutKeyCollection

Property Value

Type	Description
ChartShortcutKeyCollection	The shortcut key collection.

Property Paths

You can access this nested property as listed below:

Object Type	Path to ZoomInShortcuts
Diagram3D	.ZoomingOptions.ZoomInShortcuts
FunnelDiagram3D	.ZoomingOptions.ZoomInShortcuts
GanttDiagram	.ZoomingOptions.ZoomInShortcuts
SimpleDiagram3D	.ZoomingOptions.ZoomInShortcuts
SwiftPlotDiagram	.ZoomingOptions.ZoomInShortcuts
XYDiagram	.ZoomingOptions.ZoomInShortcuts
XYDiagram2D	.ZoomingOptions.ZoomInShortcuts
XYDiagram3D	.ZoomingOptions.ZoomInShortcuts

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