Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]Welcome to DevExpress .NET Documentation
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Collapse]Charts Suite
   [Collapse]Chart Control
    [Expand]Getting Started
    [Expand]Fundamentals
    [Expand]Providing Data
    [Expand]Appearance Customization
    [Collapse]End-User Features
     [Collapse]End-User Capabilities
       Zooming and Scrolling (2D XY-Charts)
       Zooming and Scrolling (3D Charts)
       Rotation (3D Charts)
     [Expand]Crosshair Cursor
      Tooltips
      Hit-Testing
      Selection
     [Expand]Animation
      Printing and Exporting
      Chart Designer for End-Users
    [Expand]Design-Time Features
    [Expand]Visual Elements
    [Expand]Examples
    [Expand]Additional Resources
   [Expand]Chart3D Control
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Diagram Control
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Zooming and Scrolling (3D Charts)

This document describes how to provide the capability of scrolling and zooming for 3D Charts. A similar functionality is available for 2D charts as well, which is explained at Zooming and Scrolling (2D XY-Charts).

Note

To enable gesture zooming and scrolling, the ChartControl.IsManipulationEnabled property should be set to true.

This document consists of the following sections.

Expanded Zooming a Chart

To enable a diagram's zooming, set the Diagram3D.RuntimeZooming property to true.

After zooming is enabled, it is possible to choose how it can be performed (using the keyboard and / or mouse, gestures such as spread/pinch on your touchscreen device) via the Diagram3D.NavigationOptions property.

You can provide custom cursors for chart zooming in the ChartControl.QueryChartCursor event handler.

To zoom in or out of a chart's diagram, do one of the following.

Action Effect
Press SHIFT and click the diagram. After an end-user presses the SHIFT key, the mouse pointer is changed to . Then, move the mouse pointer to the chart region to be zoomed into, and click the left mouse button (holding the SHIFT key).The chart's diagram is zoomed in by 2 times.
Press ALT and click the diagram. After an end-user presses the ALT key, the mouse pointer is changed to . Then, move the mouse pointer to the region to be zoomed out, and click the left mouse button (holding the ALT key).The chart's diagram is zoomed out by 2 times.
Use CTRL with the "+" or "-" keys. If an end-user presses and holds the CTRL key while pressing the "+" key, a chart's diagram is zoomed in by 3 percent from the current axes ranges.
If an end-user presses and holds the CTRL key while pressing the "-" key, a chart's diagram is zoomed out by 3 percent from the current axes ranges.
Use the mouse wheel. An end-user can scroll the mouse wheel to zoom in and out of a chart's diagram in the same way one can zoom when using other Windows applications.
Use the spread or pinch gestures on a touchscreen device.

An end-user can zoom in or out a chart's diagram performing either spread or pinch gestures correspondingly on any device supported touchscreen.

Use CTRL + Z combination. Pressing the CTRL + Z keys returns the previous zoom state of a chart's diagram. NOTE: All subsequent operations of a similar kind (for instance, multiple "zoom in" operations) are considered as a single transaction. Pressing CTRL + Z returns the zoom state, which existed before the first zoom operation in a zoom series.
Note

The maximum allowed zoom value for DXCharts is 500% (this means that a chart is zoomed into 5 times). When an end-user reaches this limit and presses the SHIFT key, the mouse pointer is changed to .

Expanded Scrolling a Chart

To enable diagram scrolling, set the Diagram3D.RuntimeScrolling property to true.

After scrolling is enabled, it is possible to choose how it can be performed (using the keyboard, mouse, flick gestures if you have a touchscreen device) via the Diagram3D.NavigationOptions property.

In addition, you can provide custom cursors for chart scrolling in the ChartControl.QueryChartCursor event handler.

To scroll a chart's diagram, do one of the following.

Action Effect
Use CTRL + "Arrow" keys (LEFT, UP, RIGHT or DOWN). If an end-user presses CTRL + LEFT, a chart's diagram is moved to the left.
If an end-user presses CTRL + UP, a chart's diagram is moved up.
If an end-user presses CTRL + RIGHT, a chart's diagram is moved to the right.
If an end-user presses CTRL + DOWN, a chart's diagram is moved down.
Use flick gestures on a touchscreen device.

An end-user can scroll a diagram using flick gestures on the touchscreen device.

Expanded See Also

Is this topic helpful?​​​​​​​