NavigationOptions Class

Zoom and scroll settings for the XYDiagram2D.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v24.2.dll

NuGet Package: DevExpress.Wpf.Charts

Declaration

C#

public class NavigationOptions :
    NavigationOptionsBase

VB.NET

Public Class NavigationOptions
    Inherits NavigationOptionsBase

Related API Members

The following members return NavigationOptions objects:

• XYDiagram2D.NavigationOptions

Remarks

Set the XYDiagram2D.EnableAxisXNavigation or XYDiagram2D.EnableAxisYNavigation property to true to apply NavigationOptions settings to the diagram.

Use the NavigationOptions property to define whether users can utilize keyboard shortcuts, mouse operations, and touch gestures to zoom and scroll a chart:

XAML

<dxc:XYDiagram2D
        EnableAxisXNavigation="True"
        EnableAxisYNavigation="True">
    <dxc:XYDiagram2D.NavigationOptions>
        <dxc:NavigationOptions 
            UseKeyboard="True"
            UseScrollBars="True"
            UseMouse="True"
            UseTouchDevice="True"/>
    </dxc:XYDiagram2D.NavigationOptions>
</dxc:XYDiagram2D>

The NavigationOptions.AxisXMaxZoomPercent and NavigationOptions.AxisYMaxZoomPercent properties specify zoom limits. The default maximum is x100 (10,000%). When a user reaches the limit, the mouse pointer changes to .

XAML

<dxc:XYDiagram2D
        EnableAxisXNavigation="True"
        EnableAxisYNavigation="True">
    <dxc:XYDiagram2D.NavigationOptions>
        <dxc:NavigationOptions 
            AxisXMaxZoomPercent="500" 
            AxisYMaxZoomPercent="500"/>
    </dxc:XYDiagram2D.NavigationOptions>
</dxc:XYDiagram2D>

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the NavigationOptions class.

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.

XAML

wpf-bind-a-range-control-to-a-chart-control/CS/GoldPrices/MainWindow.xaml#L37

<dxc:XYDiagram2D.NavigationOptions>
    <dxc:NavigationOptions/>
</dxc:XYDiagram2D.NavigationOptions>

Inheritance

Object

DispatcherObject

DependencyObject

Freezable

ChartDependencyObject

NavigationOptionsBase

NavigationOptions