Options
All
  • Public
  • Public/Protected
  • All
Menu

The CursorModifier provides tooltip and cursor behavior on a 2D SciChartSurface within SciChart - High Performance JavaScript Charts

remarks

To apply the CursorModifier to a SciChartSurface and add tooltip behavior, use the following code:

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

📚 Docs: https://www.scichart.com/documentation/js/v4/2d-charts/chart-modifier-api/cursor-modifier/cursor-modifier-overview/

Hierarchy

Implements

Index

Constructors

Properties

Accessors

Methods

Object literals

Constructors

constructor

Properties

Protected activePointerEvents

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

Stores info about active pointerdown events

axisLabelCornerRadius

axisLabelCornerRadius: number = 2

Gets or sets the axis label corner/border radius, in pixels

axisLabelFill

axisLabelFill: string = "#228B22"

Gets or sets both axis label fill as an HTML Color code.

axisLabelPadding

axisLabelPadding: Thickness = undefined

Gets or sets the axis label padding

axisLabelStroke

axisLabelStroke: string = "#fff"

Gets or sets both axis label text color as an HTML Color code

Protected changedPropertiesList

changedPropertiesList: string[] = []

crosshairStrokeDashArray

crosshairStrokeDashArray: number[] = []

Gets or sets the crosshair line dash array

Protected crosshairStrokeProperty

crosshairStrokeProperty: string = SciChartSurfaceBase.DEFAULT_THEME.cursorLineBrush

crosshairStrokeThickness

crosshairStrokeThickness: number = 2

Gets or sets the crosshair line strokethickness

hitTestRadius

hitTestRadius: number = 0

If this is set greater than the default of zero, the toolip will only show values for points in this radius, rather than all points on the vertical line

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

Protected isAttachedProperty

isAttachedProperty: boolean

Protected isEnabledProperty

isEnabledProperty: boolean = true

Protected isSvgOnlyProperty

isSvgOnlyProperty: 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

Protected mousePosition

mousePosition: EMousePosition = EMousePosition.OutOfCanvas

Protected parentSurfaceProperty

parentSurfaceProperty: SciChartSurface

Protected placementDivIdProperty

placementDivIdProperty: string | undefined

Protected previousPoint

previousPoint: Point | undefined

Protected receiveHandledEventsProperty

receiveHandledEventsProperty: boolean

Protected secondaryExecuteConditionProperty

secondaryExecuteConditionProperty: TModifierExecuteCondition | undefined

Protected showAxisLabelsProperty

showAxisLabelsProperty: boolean = true

showTooltip

showTooltip: boolean = false

Gets or sets whether we should display the tooltip. Default is false

Protected showXLineProperty

showXLineProperty: boolean = true

Protected showYLineProperty

showYLineProperty: boolean = true

Protected tooltipAnnotation

tooltipAnnotation: CursorTooltipSvgAnnotation | undefined

tooltipContainerBackground

tooltipContainerBackground: string = "#228B22"

Gets or sets the tooltip container background color as an HTML Color code

Protected Optional tooltipDataTemplateProperty

tooltipDataTemplateProperty: TCursorTooltipDataTemplate | undefined

tooltipLegendOffsetX

tooltipLegendOffsetX: number = 0

Gets or sets the legend X offset

tooltipLegendOffsetY

tooltipLegendOffsetY: number = 0

Gets or sets the legend Y offset

Optional tooltipLegendTemplate

tooltipLegendTemplate: TCursorTooltipSvgTemplate

Gets or sets the template for the legend

Protected tooltipShadowProperty

tooltipShadowProperty: string = SciChartSurfaceBase.DEFAULT_THEME.shadowEffectColor

Optional tooltipSvgTemplate

tooltipSvgTemplate: TCursorTooltipSvgTemplate = defaultCursorTooltipSvgTemplate

Get or set a function which generates the svg for the entire tooltip. Note that the repositioning of the tooltip to keep it within the chart is normally done in this function. To retain this functionality in your own template function, include the following:

  // valuesWithLabels is the result of the tooltipDataTemplate function, which is the text content of the tooltip as an array of strings
  const { width, height } = calcTooltipSize(valuesWithLabels);
  // this calculates and sets svgAnnotation.xCoordShift and svgAnnotation.yCoordShift.  Do not set x1 or y1 at this point.
  adjustTooltipPosition(width, height, svgAnnotation);

tooltipTextStroke

tooltipTextStroke: string = "#fff"

Gets or sets the tooltip text color as an HTML Color code

Readonly type

type: Cursor = EChart2DModifierType.Cursor

Protected typeMap

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

Protected xAxisIdProperty

xAxisIdProperty: string | undefined

xAxisLabelFill

xAxisLabelFill: string | undefined = undefined

Gets or sets the xAxis label fill as an HTML Color code.

xAxisLabelStroke

xAxisLabelStroke: string | undefined = undefined

Gets or sets the xAxis label text color as an HTML Color code

Protected xAxisProperty

xAxisProperty: AxisBase2D | undefined

Protected xLineAnnotation

xLineAnnotation: ILineAnnotation | undefined

xyDirection

xyDirection: EXyDirection = EXyDirection.XyDirection

Direction to which the modifier can be applied

Protected yAxisIdProperty

yAxisIdProperty: string | undefined

yAxisLabelFill

yAxisLabelFill: string | undefined = undefined

Gets or sets the yAxis label fill as an HTML Color code.

yAxisLabelStroke

yAxisLabelStroke: string | undefined = undefined

Gets or sets the xAxis label text color as an HTML Color code

Protected yAxisProperty

yAxisProperty: AxisBase2D | undefined

Protected yLineAnnotation

yLineAnnotation: ILineAnnotation | undefined

Accessors

canReceiveMouseEvents

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

    inheritdoc

    Returns boolean

crosshairStroke

  • get crosshairStroke(): string
  • set crosshairStroke(value: string): void
  • Gets or sets the crosshair line Stroke color as an HTML Color code

    Returns string

  • Gets or sets the crosshair line Stroke color as an HTML Color code

    Parameters

    • value: string

    Returns void

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

isSvgOnly

  • get isSvgOnly(): boolean
  • set isSvgOnly(value: boolean): void
  • Gets or sets whether we should draw the Line & Tooltips only using SVG, else they will be drawn natively.

    Returns boolean

  • Gets or sets whether we should draw the Line & Tooltips only using SVG, else they will be drawn natively.

    Parameters

    • value: boolean

    Returns void

modifierType

parentSurface

placementDivId

  • get placementDivId(): string
  • set placementDivId(value: string): void
  • Gets or sets the parent div element reference or id for the Tooltip

    Returns string

  • Gets or sets the parent div element reference or id for the Tooltip

    Parameters

    • value: string

    Returns void

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

showAxisLabels

  • get showAxisLabels(): boolean
  • set showAxisLabels(value: boolean): void
  • Gets or sets whether we should display the Axis Labels. Default is true

    Returns boolean

  • Gets or sets whether we should display the Axis Labels. Default is true

    Parameters

    • value: boolean

    Returns void

showXLine

  • get showXLine(): boolean
  • set showXLine(value: boolean): void
  • Gets or sets whether we should display the X Line. Default is true

    Returns boolean

  • Gets or sets whether we should display the X Line. Default is true

    Parameters

    • value: boolean

    Returns void

showYLine

  • get showYLine(): boolean
  • set showYLine(value: boolean): void
  • Gets or sets whether we should display the Y Line. Default is true

    Returns boolean

  • Gets or sets whether we should display the Y Line. Default is true

    Parameters

    • value: boolean

    Returns void

tooltipDataTemplate

  • Gets or sets the tooltipDataTemplate, which allows to customize content for the tooltip

    Returns TCursorTooltipDataTemplate

  • Gets or sets the tooltipDataTemplate, which allows to customize content for the tooltip

    Parameters

    Returns void

tooltipShadow

  • get tooltipShadow(): string
  • set tooltipShadow(value: string): void
  • Gets or sets the tooltip shadow color as an HTML Color code

    Returns string

  • Gets or sets the tooltip shadow color as an HTML Color code

    Parameters

    • value: string

    Returns void

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

getMousePosition

Protected getSeriesInfos

  • Returns SeriesInfo[]

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

hitTestRenderableSeries

  • Override hitTestRenderableSeries and add a custom logic here

    Parameters

    Returns HitTestInfo

includeAllAxes

  • includeAllAxes(): void

includeSeries

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

Protected isVerticalChart

  • isVerticalChart(): boolean
  • Returns boolean

linkAxes

  • linkAxes(): void
  • inheritdoc

    Returns void

modifierDoubleClick

modifierDrop

modifierMouseDown

modifierMouseEnter

modifierMouseLeave

modifierMouseMove

modifierMouseUp

modifierMouseWheel

modifierPointerCancel

Protected newLineAnnotation

  • newLineAnnotation(axisLabelFill: string, axisLabelStroke: string): ILineAnnotation
  • Parameters

    • axisLabelFill: string
    • axisLabelStroke: string

    Returns ILineAnnotation

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 }
  • Convert the object to a definition that can be serialized to JSON, or used directly with the builder api

    Returns { options: {}; type: string }

    • options: {}
    • type: string

Protected update

  • update(): void
  • Returns void

Protected updatePointerInfo

Object literals

Protected executeConditionProperty

executeConditionProperty: object

button

button: MouseLeftButton = EExecuteOn.MouseLeftButton

showOnOthersInGroup

showOnOthersInGroup: object

tooltip

tooltip: true = true

xLine

xLine: true = true

yLine

yLine: true = true

Generated using TypeDoc