Options
All
  • Public
  • Public/Protected
  • All
Menu

The ZoomExtentsModifier provides double-tap or double-click to zoom-to-fit (Zoom Extents) behavior on a 2D SciChartSurface within SciChart - High Performance JavaScript Charts

remarks

To apply the ZoomExtentsModifier to a SciChartSurface and add drag to zoom behavior, use the following code:

const sciChartSurface: SciChartSurface;
sciChartSurface.chartModifiers.add(new ZoomExtentsModifier());

Animation of the zoom extents be controlled via the ZoomExtentsModifier.isAnimated, ZoomExtentsModifier.animationDuration and ZoomExtentsModifier.easingFunction properties.


📚 Docs: https://www.scichart.com/documentation/js/v4/2d-charts/chart-modifier-api/zooming-and-panning/zoom-extents-modifier/

Hierarchy

Implements

Index

Constructors

constructor

Properties

Protected activePointerEvents

activePointerEvents: Map<number, ModifierMouseArgs> = new Map()

Stores info about active pointerdown events

animationDuration

animationDuration: number = 400

Defines the duration of animations when zooming in milliseconds

applyToAxes

applyToAxes: boolean = true

Whether the modifier applies when the mouse is over the axes. Default true.

applyToSeriesViewRect

applyToSeriesViewRect: boolean = true

Whether the modifier applies when the mouse is over the area where series are drawn (ie not over the axes). Default true.

Protected changedPropertiesList

changedPropertiesList: string[] = []

easingFunction

easingFunction: TEasingFn = easing.outExpo

Defines the easing function for animation. See TEasingFn for a range of functions

Readonly id

id: string

A unique Id for the IChartModifierBase

includedSeries

includedSeries: IncludedItems = new IncludedItems()

The helper property to get and set the list of included renderable series

includedXAxes

includedXAxes: IncludedItems = new IncludedItems()

The helper property to get and set the list of included X axes

includedYAxes

includedYAxes: IncludedItems = new IncludedItems()

The helper property to get and set the list of included Y axes

invalidateParentCallback

invalidateParentCallback: () => void

A callback to invalidate the parent SciChartSurfaceBase

Type declaration

    • (): void
    • Returns void

isAnimated

isAnimated: boolean = true

When true, the Zoom operations are animated. See also animationDuration and easingFunction

Protected isAttachedProperty

isAttachedProperty: boolean

Protected isEnabledProperty

isEnabledProperty: boolean = true

modifierGroup

modifierGroup: string | undefined

Specifies a string ID to group modifiers.

remarks

When one receives a mouse event, all modifiers in the same group receive the event.

Protected mousePoint

mousePoint: Point | undefined

Optional onZoomExtents

onZoomExtents: (sciChartSurface: SciChartSurface) => boolean

A function to execute when zoomExtents is activated. If this exists and returns false, the builtin behaviour is ignored;

Type declaration

Protected parentSurfaceProperty

parentSurfaceProperty: SciChartSurface

Protected previousPoint

previousPoint: Point | undefined

Protected receiveHandledEventsProperty

receiveHandledEventsProperty: boolean

Protected secondaryExecuteConditionProperty

secondaryExecuteConditionProperty: TModifierExecuteCondition | undefined

Readonly type

type: EChart2DModifierType = EChart2DModifierType.ZoomExtents

Protected typeMap

typeMap: Map<string, string> = new Map<string, string>()

Protected xAxisIdProperty

xAxisIdProperty: string | undefined

Protected xAxisProperty

xAxisProperty: AxisBase2D | undefined

xyDirection

xyDirection: EXyDirection = EXyDirection.XyDirection

Direction to which the modifier can be applied

Protected yAxisIdProperty

yAxisIdProperty: string | undefined

Protected yAxisProperty

yAxisProperty: AxisBase2D | undefined

Accessors

canReceiveMouseEvents

  • get canReceiveMouseEvents(): boolean
  • When true, this modifier can receive mouse events

    inheritdoc

    Returns boolean

executeCondition

isAttached

  • get isAttached(): boolean

isEnabled

  • get isEnabled(): boolean
  • set isEnabled(isEnabled: boolean): void
  • When true, the modifier is enabled

    inheritdoc

    Returns boolean

  • When true, the modifier is enabled

    inheritdoc

    Parameters

    • isEnabled: boolean

    Returns void

modifierType

parentSurface

receiveHandledEvents

  • get receiveHandledEvents(): boolean
  • set receiveHandledEvents(receiveHandledEvents: boolean): void
  • When true, this modifier should receive events which have been handled by modifiers higher up in the call hierachy.

    inheritdoc

    Returns boolean

  • When true, this modifier should receive events which have been handled by modifiers higher up in the call hierachy.

    inheritdoc

    Parameters

    • receiveHandledEvents: boolean

    Returns void

secondaryExecuteCondition

xAxis

xAxisId

  • get xAxisId(): string
  • set xAxisId(xAxisId: string): void
  • inheritdoc

    Returns string

  • inheritdoc

    Parameters

    • xAxisId: string

    Returns void

yAxis

yAxisId

  • get yAxisId(): string
  • set yAxisId(yAxisId: string): void
  • inheritdoc

    Returns string

  • inheritdoc

    Parameters

    • yAxisId: string

    Returns void

Methods

applyTheme

checkExecuteCondition

checkExecuteConditions

  • checkExecuteConditions(args: ModifierMouseArgs): { isPrimary: boolean | undefined; isSecondary: boolean | undefined }
  • Checks execute primary and secondary conditions

    Parameters

    Returns { isPrimary: boolean | undefined; isSecondary: boolean | undefined }

    • isPrimary: boolean | undefined
    • isSecondary: boolean | undefined

delete

  • delete(): void
  • Deletes native (WebAssembly) memory used by this type, after which it cannot be used.

    remarks

    Call .delete() before finishing with the object to ensure that WebAssmembly memory leaks do not occur.

    All elements within SciChart's High Performance Realtime JavaScript Charts which implement IDeletable must be deleted manually to free native (WebAssembly) memory

    Returns void

Protected getAllSeries

getIncludedRenderableSeries

  • Returns all visible and included renderable series. The list also contains included visible stacked renderable series This calls this.testIsIncludedSeries so it is best to customise the including check behaviour there.

    Returns IRenderableSeries[]

getIncludedXAxis

getIncludedYAxis

Protected getIsActionAllowed

Protected growBy

  • Grows the Axis by a fraction around the mouse point

    Parameters

    • mousePoint: Point

      the X,Y location of the mouse at the time of the operation

    • axis: AxisBase2D

      the Axis to grow or shrink

    • fraction: number

      the fraction, e.g. 0.1 grows the axis by 10%

    Returns void

includeAllAxes

  • includeAllAxes(): void

includeSeries

  • Includes renderable series. Returns True if the included items list has changed after the operation.

    Parameters

    Returns boolean

includeXAxis

  • includeXAxis(axis: AxisBase2D, isIncluded: boolean): void
  • Includes or excludes X axis

    Parameters

    Returns void

includeYAxis

  • includeYAxis(axis: AxisBase2D, isIncluded: boolean): void
  • Includes or excludes Y axis

    Parameters

    Returns void

linkAxes

  • linkAxes(): void
  • inheritdoc

    Returns void

modifierDoubleClick

modifierDrop

modifierMouseDown

modifierMouseEnter

modifierMouseLeave

modifierMouseMove

modifierMouseUp

modifierMouseWheel

modifierPointerCancel

Protected notifyPropertyChanged

  • notifyPropertyChanged(propertyName: string): void

onAttach

  • onAttach(): void

onAttachSeries

onAttachSubSurface

onDetach

  • onDetach(): void

onDetachSeries

onDetachSubSurface

onParentSurfaceLayoutComplete

  • onParentSurfaceLayoutComplete(): void

onParentSurfaceRendered

  • onParentSurfaceRendered(): void

setParentSurface

Protected testPropertyChanged

  • testPropertyChanged(propertyName: string): boolean

toJSON

  • toJSON(): { options: {}; type: string }

Protected updatePointerInfo

Object literals

Protected executeConditionProperty

executeConditionProperty: object

button

button: MouseLeftButton = EExecuteOn.MouseLeftButton

Generated using TypeDoc