Class AbstractCursor<CursorPositionType, ResultTableBackgroundType>Abstract

Type Parameters

  • CursorPositionType extends AbstractCursorPosition = AbstractCursorPosition

  • ResultTableBackgroundType extends UIBackground = UIBackground

Hierarchy

Implements

Properties

scale: ScaleXY<ViewportScale1D>

Methods

  • Add callback function to be triggered when specified event is fired.

     // Example syntax
    object.addEventListener('click', (event) => {
    console.log(event)
    })

    Some classes also report extra information about the interacted object with the second parameter:

     // Most series share information about interacted data point
    series.addEventListener('click', (event, info) => {
    console.log(info)
    })

    Optional third parameter allows registering event handlers that will automatically remove themselves after first trigger:

     // Example this listener will only fire once
    object.addEventListener('click', (event) => {})

    Each class has its own list of supported events. Some events are from HTML standard (click, pointerdown, etc.), while others are own events from LightningChart JS (dispose, resize, etc.)

    To find what events are available, you can try following:

    • If your development environment has TypeScript enabled, just write addEventListener and see what possible event types the IDE suggests. These APIs are strongly typed, and even the callback event will be correctly typed.
    • Otherwise, open the class section in API documentation and check out which interface K type parameter extends.

    Type Parameters

    • K extends "dispose"

    Parameters

    Returns void

  • Permanently destroy the component.

    To fully allow Garbage-Collection to free the resources used by the component, make sure to remove any references to the component and its children in application code.

    let chart = ...ChartXY()
    let axisX = chart.getDefaultAxisX()
    // Dispose Chart, and remove all references so that they can be garbage-collected.
    chart.dispose()
    chart = undefined
    axisX = undefined

    Returns

    Object itself for fluent interface

    Returns AbstractCursor<CursorPositionType, ResultTableBackgroundType>

  • Get is auto-fit enabled. Affects logic of automatic fitting of Cursors ResultTable to the screen.

    Returns

    Boolean flag whether auto-fit is enabled

    Returns boolean

  • Get point marker visible or not.

    Returns

    Boolean.

    Returns boolean

  • Get result table visible or not.

    Returns

    Boolean.

    Returns boolean

  • Get element visibility.

    Returns

    true when element is set to be visible and false otherwise.

    Returns boolean

  • Check whether the object is disposed. Disposed objects should not be used!

    Returns

    true if object is disposed.

    Returns boolean

  • Remove event listener added using addEventListener. The expected argument should be the exact same callback function that was supplied using addEventListener:

     // Basic example syntax
    const listener = () => {}
    obj.addEventListener('click', listener)
    obj.removeEventListener('click', listener)
     // Basic boilerplate of custom interaction when user drags on an object
    obj.addEventListener('pointerdown', (eventDown) => {
    let prevCoord = eventDown
    const handlePointerMove: LCJSInteractionEventListener<'pointermove'> = (eventMove) => {
    const delta = { x: eventMove.clientX - prevCoord.clientX, y: eventMove.clientY - prevCoord.clientY }
    prevCoord = eventMove
    console.log(delta, eventMove.clientX, eventMove.clientY)
    }
    const handlePointerUp: LCJSInteractionEventListener<'pointerup'> = (eventUp) => {
    window.removeEventListener('pointermove', handlePointerMove)
    window.removeEventListener('pointerup', handlePointerUp)
    }
    window.addEventListener('pointermove', handlePointerMove)
    window.addEventListener('pointerup', handlePointerUp)
    })

    Type Parameters

    • K extends "dispose"

    Parameters

    Returns void

  • Set auto-fit strategy of Cursor. Affects logic of automatic fitting of Cursors ResultTable to the screen.

    Returns

    Object itself for fluent interface

    Parameters

    • Optional autoFitStrategy: AutoFitStrategyFactory

      AutoFitStrategy factory or undefined to disable auto-fitting

    Returns AbstractCursor<CursorPositionType, ResultTableBackgroundType>

  • Mutator function for Cursors PointMarker. PointMarker is a visual that is displayed at the Cursors position

    Returns

    Object itself for fluent interface

    Parameters

    Returns AbstractCursor<CursorPositionType, ResultTableBackgroundType>

  • Set point marker visible or not.

    Returns

    Object itself.

    Parameters

    • visible: boolean

      Point marker visible?

    Returns AbstractCursor<CursorPositionType, ResultTableBackgroundType>

  • Set cursor position.

    Returns

    Object itself.

    Parameters

    • Rest ...cursorPositions: CursorPositionType[]

      Abstract interface that describes cursor position. Actual type depends on type of cursor (XY, 3D, Polar, etc...)

    Returns AbstractCursor<CursorPositionType, ResultTableBackgroundType>

  • Mutator function for Cursors ResultTable. ResultTable is a visual that displays currently pointed data next to its location

    Returns

    Object itself for fluent interface

    Parameters

    • mutator: Mutator<ResultTable<ResultTableBackgroundType>>

      Mutator function for ResultTable

    Returns AbstractCursor<CursorPositionType, ResultTableBackgroundType>

  • Set result table visible or not.

    Returns

    Object itself.

    Parameters

    • visible: boolean

      Result table visible?

    Returns AbstractCursor<CursorPositionType, ResultTableBackgroundType>

  • Set element visibility.

    Returns

    Object itself.

    Parameters

    • state: boolean

      true when element should be visible and false when element should be hidden.

    Returns AbstractCursor<CursorPositionType, ResultTableBackgroundType>