iOS & macOS Charting Documentation - SciChart iOS & macOS Charts SDK v4.x

The SCIXAxisDragModifier

SciChart iOS provides scale or pan an X Axis via the SCIXAxisDragModifier, available out of the box.

Besides common features which are inherited from the SCIChartModifierBase class, the SCIXAxisDragModifier allows to control its specific features via the following properties:

SCIAxisDragModifierBase.dragMode - allows to change the default axis scaling behavior to axis panning behavior - similarly to SCIxAxisDragModifier via the SCIAxisDragMode enumeration.
SCIAxisDragModifierBase.minTouchArea - configures the sensitivity of the modifier.
SCIXAxisDragModifier.clipModeX - allows to specify the behavior when scrolling reaches data extents in X direction via the SCIClipMode enumeration.
SCIXAxisDragModifier.clipModeTargetX - allows to specify which target is used as limit by clipModeX when you reach the edge of the X-Axis extents.

Adding a SCIXAxisDragModifier to a Chart

Any Chart Modifier can be added to a SCIChartSurface via the ISCIChartSurface.chartModifiers property and SCIXAxisDragModifier with no difference:

    // Assume a surface has been created and configured somewhere
    id<ISCIChartSurface> surface;

    // Create a Modifier
    SCIXAxisDragModifier *xAxisDragModifier = [SCIXAxisDragModifier new];
    xAxisDragModifier.dragMode = SCIAxisDragMode_Pan;
    xAxisDragModifier.clipModeX = SCIClipMode_StretchAtExtents;
    xAxisDragModifier.clipModeTargetX = SCIClipModeTarget_MaximumRange;

    // Add the modifier to the surface
    [self.surface.chartModifiers add:xAxisDragModifier];

    // Assume a surface has been created and configured somewhere
    let surface: ISCIChartSurface

    // Create a Modifier
    let xAxisDragModifier = SCIXAxisDragModifier()
    xAxisDragModifier.dragMode = .pan
    xAxisDragModifier.clipModeX = .stretchAtExtents
    xAxisDragModifier.clipModeTargetX = .maximumRange

    // Add the modifier to the surface
    self.surface.chartModifiers.add(xAxisDragModifier)

    // Assume a surface has been created and configured somewhere
    IISCIChartSurface surface;

    // Create a Modifier
    var xAxisDragModifier = new SCIXAxisDragModifier();
    xAxisDragModifier.DragMode = SCIAxisDragMode.Pan;
    xAxisDragModifier.ClipModeX = SCIClipMode.StretchAtExtents;
    xAxisDragModifier.ClipModeTargetX = SCIClipModeTarget.MaximumRange;

    // Add the modifier to the surface
    Surface.ChartModifiers.Add(xAxisDragModifier);

Include/Exclude Certain Axis

The SCIXAxisDragModifier allows you to include or exclude certain axis from the axis drag operation. This feature is especially useful in multiple-axis charts, where you may want to zoom/pan only selected axes while keeping others fixed. By default all axis are included, to exclude one or more X axis, set the following property:

// Exclude a specific axis from the pan zoom operation
[xAxisDragModifier includeXAxis:xAxis isIncluded:NO];

// Include a specific axis from the pan zoom operation
[xAxisDragModifier includeXAxis:xAxis isIncluded:YES];

// Reset flags
[xAxisDragModifier includeAll];
[xAxisDragModifier excludeAll];

// Exclude a specific axis from the pan zoom operation
xAxisDragModifier.includeXAxis(xAxis, isIncluded: false)

// Include a specific axis from the pan zoom operation
xAxisDragModifier.includeXAxis(xAxis, isIncluded: true)

// Reset flags
xAxisDragModifier.includeAll()
xAxisDragModifier.excludeAll()

NOTE: To learn more about features available, please visit the Chart Modifier APIs article.

SCIAxisDragModifier

SciChart has introduced a new modifier, SCIAxisDragModifier, which combines the functionality of both SCIXAxisDragModifier and SCIYAxisDragModifier. This unified modifier allows you to configure drag behavior for the X-axis, Y-axis, or both axes simultaneously, eliminating the need to declare two separate modifiers.

Why Use SCIAxisDragModifier?

Previously, to enable drag interactions on both axes, you needed to add:

SCIXAxisDragModifier (for the X-axis), and
SCIYAxisDragModifier (for the Y-axis)

With the new SCIAxisDragModifier, you can now accomplish the same behavior plus combined-axis dragging with one modifier.

SCIAxisDragModifier *axisDragModifier = [SCIAxisDragModifier new];

// Choose the drag behavior: zoom (SCIDragMode_Scale) or pan (SCIDragMode_Pan)
axisDragModifier.dragMode = SCIDragMode_Scale;    // or SCIDragMode_Pan

// Choose affected axis/axes
axisDragModifier.direction = SCIDirection_XDirection;      // X axis
// axisDragModifier.direction = SCIDirection_YDirection;   // Y axis
// axisDragModifier.direction = SCIDirection_XYDirection;  // Both axes together

let axisDragModifier = SCIAxisDragModifier()

// Choose the drag behavior: zoom (.scale) or pan (.pan)
axisDragModifier.dragMode = .scale   // or .pan

// Choose affected axis/axes
axisDragModifier.direction = .xDirection     // X axis
// axisDragModifier.direction = .yDirection  // Y axis
// axisDragModifier.direction = .xyDirection // Both axes together

NOTE: For new projects, SciChart recommends using SCIAxisDragModifier as the preferred, modern, and more flexible approach to axis dragging.