Options
All
  • Public
  • Public/Protected
  • All
Menu

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

remarks

To apply the PolarCursorModifier to a SciChartPolarSurface and add tooltip behavior, use the following code:

const sciChartSurface: SciChartPolarSurface;
sciChartSurface.chartModifiers.add(new PolarCursorModifier());

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

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

Protected angularAxisLabelAnnotation

angularAxisLabelAnnotation: NativeTextAnnotation | undefined

Protected angularAxisLabelPlacementProperty

angularAxisLabelPlacementProperty: EAngularAxisLabelPlacement = EAngularAxisLabelPlacement.Outer

axisLabelFill

axisLabelFill: string = "#228B22"

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

axisLabelStroke

axisLabelStroke: string = "#fff"

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

Protected changedPropertiesList

changedPropertiesList: string[] = []

Protected circularAnnotation

circularAnnotation: PolarArcAnnotation | undefined

hitTestRadius

hitTestRadius: number = 0

If this is set greater than the default of zero, the tooltip 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 lineColorProperty

lineColorProperty: string = SciChartSurfaceBase.DEFAULT_THEME.cursorLineBrush

lineDashArray

lineDashArray: number[] = []

Gets or sets the crosshair line dash array

lineThickness

lineThickness: number = 2

Gets or sets the crosshair line stroke thickness

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 radialAnnotation

radialAnnotation: LineAnnotation | undefined

Protected radialAxisLabelAnnotation

radialAxisLabelAnnotation: NativeTextAnnotation | undefined

Protected radialAxisLabelPlacementProperty

radialAxisLabelPlacementProperty: ERadialAxisLabelPlacement = ERadialAxisLabelPlacement.Bottom

Protected receiveHandledEventsProperty

receiveHandledEventsProperty: boolean

Protected secondaryExecuteConditionProperty

secondaryExecuteConditionProperty: TModifierExecuteCondition | undefined

Protected showAxisLabelsProperty

showAxisLabelsProperty: boolean = true

Protected showCircularLineProperty

showCircularLineProperty: boolean = true

Protected showRadialLineProperty

showRadialLineProperty: boolean = true

showTooltip

showTooltip: boolean = false

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

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: PolarCursor = EChart2DModifierType.PolarCursor

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

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

Accessors

angularAxisLabelPlacement

  • Gets or sets angular axis label placement

    Returns EAngularAxisLabelPlacement

  • Gets or sets angular axis label placement

    Parameters

    Returns void

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

lineColor

  • get lineColor(): string
  • set lineColor(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

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

radialAxisLabelPlacement

  • Gets or sets radial axis label placement

    Returns ERadialAxisLabelPlacement

  • Gets or sets radial axis label placement

    Parameters

    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

showCircularLine

  • get showCircularLine(): boolean
  • set showCircularLine(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

showRadialLine

  • get showRadialLine(): boolean
  • set showRadialLine(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

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 newArcAnnotation

  • Parameters

    • axisLabelFill: string
    • axisLabelStroke: string

    Returns PolarArcAnnotation

Protected newLineAnnotation

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

    • axisLabelFill: string
    • axisLabelStroke: string

    Returns LineAnnotation

Protected newNativeTextAnnotation

  • Parameters

    • axisLabelFill: string
    • axisLabelStroke: string

    Returns NativeTextAnnotation

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

Generated using TypeDoc