Options
All
  • Public
  • Public/Protected
  • All
Menu
summary

The NativeTextAnnotation provides an Annotation which draws a text at specific x1 y1 over the SciChartSurface

description

To add a NativeTextAnnotation to a SciChartSurface, use the following code:

const sciChartSurface: SciChartSurface;
const textAnnotation = new NativeTextAnnotation( { x1: 1, y1: 3, color: "#FF000077", text: "Hello SciChart"});
sciChartSurface.annotations.add(textAnnotation);
remarks

Uses the fast WebGL/WebAssembly {@link WebGL2RenderingContext} for rendering

Hierarchy

Implements

Index

Constructors

Properties

Accessors

Methods

Object literals

Constructors

constructor

Properties

Protected adornerClippingProperty

adornerClippingProperty: EAnnotationClippingMode | string = EAnnotationClippingMode.Chart

Protected adornerDraggingPointProperty

adornerDraggingPointProperty: EDraggingGripPoint

Protected annotationsGripsFillProperty

annotationsGripsFillProperty: string = SciChartSurfaceBase.DEFAULT_THEME.annotationsGripsBackgroundBrush

Protected annotationsGripsRadiusProperty

annotationsGripsRadiusProperty: number = ADORNER_GRIP_RADIUS

Protected annotationsGripsStrokeProperty

annotationsGripsStrokeProperty: string = SciChartSurfaceBase.DEFAULT_THEME.annotationsGripsBorderBrush

Protected backgroundProperty

backgroundProperty: string | undefined

clicked

Protected clippingProperty

clippingProperty: EAnnotationClippingMode | string = EAnnotationClippingMode.SeriesViewRect

dragDelta

dragEnded

dragEnded: EventHandler<void>

Protected dragPointsProperty

dragPointsProperty: keyof EDraggingGripPoint[] = [EDraggingGripPoint.Body,EDraggingGripPoint.x1y1,EDraggingGripPoint.x2y2,EDraggingGripPoint.x2y1,EDraggingGripPoint.x1y2]

dragStarted

dragStarted: EventHandler<void>

Protected Optional fontFamilyProperty

fontFamilyProperty: string = getDefaultFontName()

Protected Optional fontSizeProperty

fontSizeProperty: number = 14

Protected horizontalAnchorPointProperty

horizontalAnchorPointProperty: EHorizontalAnchorPoint = EHorizontalAnchorPoint.Left

hovered

Readonly id

id: string

A unique Id for the IAnnotation

invalidateParentCallback

invalidateParentCallback: (options?: { force?: boolean; svgOnly?: boolean }) => void
description

callback which notifies the parent SciChartSurface it's time to draw

Type declaration

    • (options?: { force?: boolean; svgOnly?: boolean }): void
    • Parameters

      • Optional options: { force?: boolean; svgOnly?: boolean }
        • Optional force?: boolean
        • Optional svgOnly?: boolean

      Returns void

Protected invalidateState

invalidateState: { isHidden: boolean; x1: number; y1: number }

Type declaration

  • isHidden: boolean
  • x1: number
  • y1: number

Readonly isDomAnnotation

isDomAnnotation: boolean = false

Protected isHiddenProperty

isHiddenProperty: boolean = false

Readonly isSvgAnnotation

isSvgAnnotation: boolean = false
description

defines if the annotation is SVG annotation

Protected Optional lineSpacingProperty

lineSpacingProperty: number = 3

Protected Optional multiLineAlignmentProperty

multiLineAlignmentProperty: EMultiLineAlignment = EMultiLineAlignment.Center

Protected paddingProperty

paddingProperty: Thickness = Thickness.fromNumber(2)

Protected parentSurfaceProperty

parentSurfaceProperty: SciChartSurfaceBase

Protected prevIsSelected

prevIsSelected: boolean = true

Protected prevValue

prevValue: { x: number; y: number }

Type declaration

  • x: number
  • y: number

Protected renderLayerProperty

renderLayerProperty: EDefaultRenderLayer | number

Protected renderNextToProperty

renderNextToProperty: { offset: number; renderable: IOrderedRenderable | string }

Type declaration

Protected renderOrderProperty

renderOrderProperty: number = undefined

Protected rotationProperty

rotationProperty: number = 0

scaleOnResize

scaleOnResize: boolean = false

Set true to make the font scale when the annotation is resized. Must set x2 as well. Cannot be used with wrapTo

Protected Optional scaleProperty

scaleProperty: number = 1

selectedChanged

selectedChanged: EventHandler<boolean>

Protected selectionBoxDeltaProperty

selectionBoxDeltaProperty: number = 1.5

Protected selectionBoxStrokeProperty

selectionBoxStrokeProperty: string = SciChartSurfaceBase.DEFAULT_THEME.annotationSelectionStroke

Protected selectionBoxThicknessProperty

selectionBoxThicknessProperty: number = 6

Protected surfaceRenderOrderProperty

surfaceRenderOrderProperty: number = undefined

Readonly surfaceTypes

surfaceTypes: ESurfaceType[] = [ESurfaceType.SciChartSurfaceType,ESurfaceType.SciChartPolarSurfaceType]
description

compatible surface types. See EAnnotationType for a list of values

Protected svgAdorner

svgAdorner: SVGElement

Protected textColorProperty

textColorProperty: string = "#ffffff"

Protected textProperty

textProperty: string = ""

Readonly type

type: EAnnotationType = EAnnotationType.RenderContextNativeTextAnnotation
description

annotation type. See EAnnotationType for a list of values

Protected typeMap

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

Protected verticalAnchorPointProperty

verticalAnchorPointProperty: EVerticalAnchorPoint = EVerticalAnchorPoint.Top

Protected Optional wrapToProperty

wrapToProperty: number | EWrapTo

Protected x1Property

x1Property: number

Protected xCoordinateModeProperty

xCoordinateModeProperty: ECoordinateMode = ECoordinateMode.DataValue

Protected y1Property

y1Property: number

Protected yCoordinateModeProperty

yCoordinateModeProperty: ECoordinateMode = ECoordinateMode.DataValue

Accessors

adornerClipping

adornerDraggingPoint

annotationLayer

annotationsGripsFill

  • get annotationsGripsFill(): string
  • set annotationsGripsFill(color: string): void

annotationsGripsRadius

  • get annotationsGripsRadius(): number
  • set annotationsGripsRadius(radius: number): void

annotationsGripsStroke

  • get annotationsGripsStroke(): string
  • set annotationsGripsStroke(color: string): void

background

  • get background(): string
  • set background(htmlColorCode: string): void
  • Gets the background for the NativeTextAnnotation

    remarks

    Acceptable values include RGB format e.g. #FF0000, RGBA format e.g. #FF000077`` and RGBA format e.g.rgba(255,0,0,0.5)```

    Returns string

  • Sets the background for the NativeTextAnnotation

    remarks

    Acceptable values include RGB format e.g. #FF0000, RGBA format e.g. #FF000077`` and RGBA format e.g.rgba(255,0,0,0.5)```

    Parameters

    • htmlColorCode: string

    Returns void

clipping

dragPoints

fontFamily

  • get fontFamily(): string
  • set fontFamily(value: string): void
  • Gets the fontSize for the NativeTextAnnotation

    Returns string

  • Sets the fontSize for the NativeTextAnnotation

    Parameters

    • value: string

    Returns void

fontSize

  • get fontSize(): number
  • set fontSize(value: number): void
  • Gets the fontSize for the NativeTextAnnotation

    Returns number

  • Sets the fontSize for the NativeTextAnnotation

    Parameters

    • value: number

    Returns void

horizontalAnchorPoint

  • Gets or sets horizontal anchor point

    Returns EHorizontalAnchorPoint

  • Gets or sets horizontal anchor point

    Parameters

    Returns void

isDraggingStarted

  • get isDraggingStarted(): boolean

isEditable

  • get isEditable(): boolean
  • set isEditable(isEditable: boolean): void

isHidden

  • get isHidden(): boolean
  • set isHidden(isHidden: boolean): void

isHovered

  • get isHovered(): boolean
  • set isHovered(value: boolean): void
  • Defines if the entity is hovered

    inheritdoc

    Returns boolean

  • Defines if the entity is hovered

    inheritdoc

    Parameters

    • value: boolean

    Returns void

isSelected

  • get isSelected(): boolean
  • set isSelected(value: boolean): void

isVerticalChart

  • get isVerticalChart(): boolean

isVisible

  • get isVisible(): boolean
  • set isVisible(value: boolean): void

lineSpacing

  • get lineSpacing(): number
  • set lineSpacing(value: number): void
  • The spacing between lines. Default 3 If a whole number then treated as pixels. If between 0 and 1 then treated as a fraction of line height

    Returns number

  • The spacing between lines. Default 3 If a whole number then treated as pixels. If between 0 and 1 then treated as a fraction of line height

    Parameters

    • value: number

    Returns void

multiLineAlignment

  • Gets or sets the horizontal alignment mode for multiline text

    Returns EMultiLineAlignment

  • Gets or sets the horizontal alignment mode for multiline text

    Parameters

    Returns void

opacity

  • get opacity(): number
  • set opacity(opacity: number): void
  • Sets an opacity override for the entire annotation, from 0..1

    inheritdoc

    Returns number

  • Sets an opacity override for the entire annotation, from 0..1

    inheritdoc

    Parameters

    • opacity: number

    Returns void

padding

parentSurface

resizeDirections

rotation

  • get rotation(): number
  • set rotation(value: number): void
  • Gets the rotation for the NativeTextAnnotation

    Returns number

  • Sets the rotation for the NativeTextAnnotation

    Parameters

    • value: number

    Returns void

scale

  • get scale(): number
  • set scale(value: number): void
  • The scale factor for the font. Default 1 This changes the size of the text without needing to create a new font with a different size

    Returns number

  • The scale factor for the font. Default 1 This changes the size of the text without needing to create a new font with a different size

    Parameters

    • value: number

    Returns void

selectionBoxDelta

  • get selectionBoxDelta(): number
  • set selectionBoxDelta(delta: number): void
  • How much bigger the selection box is than the bounding box of the annotation, in pixels

    inheritdoc

    Returns number

  • How much bigger the selection box is than the bounding box of the annotation, in pixels

    inheritdoc

    Parameters

    • delta: number

    Returns void

selectionBoxStroke

  • get selectionBoxStroke(): string
  • set selectionBoxStroke(color: string): void

selectionBoxThickness

  • get selectionBoxThickness(): number
  • set selectionBoxThickness(delta: number): void

Protected svgAdornerRoot

  • get svgAdornerRoot(): SVGSVGElement

text

  • get text(): string
  • set text(value: string): void
  • Gets the text for the NativeTextAnnotation

    Returns string

  • Sets the text for the NativeTextAnnotation

    Parameters

    • value: string

    Returns void

textColor

  • get textColor(): string
  • set textColor(value: string): void
  • Gets the color for the NativeTextAnnotation

    Returns string

  • Sets the color for the NativeTextAnnotation

    Parameters

    • value: string

    Returns void

verticalAnchorPoint

  • Gets or sets vertical anchor point

    Returns EVerticalAnchorPoint

  • Gets or sets vertical anchor point

    Parameters

    Returns void

wrapTo

  • Gets or sets the text wrapping mode. A pure number will be treated as a pixel width. Default is undefined meaning no wrap

    Returns number | ViewRect | Annotation

  • Gets or sets the text wrapping mode. A pure number will be treated as a pixel width. Default is undefined meaning no wrap

    Parameters

    Returns void

x1

  • get x1(): number
  • set x1(x1: number): void

x2

  • get x2(): number
  • set x2(x2: number): void

xAxis

xAxisId

  • get xAxisId(): string | undefined
  • set xAxisId(xAxisId: string): void

xCoordinateMode

y1

  • get y1(): number
  • set y1(y1: number): void

y2

  • get y2(): number
  • set y2(y2: number): void

yAxis

yAxisId

  • get yAxisId(): string | undefined
  • set yAxisId(yAxisId: string): void

yCoordinateMode

Methods

Protected applyPixelRatioToDragDist

  • applyPixelRatioToDragDist(dist: number): number

Protected applySvgClipping

calcDragDistance

  • calcDragDistance(xyValues: Point): void

canDragPoint

checkIsClickedOnAnnotation

  • checkIsClickedOnAnnotation(x: number, y: number): boolean

Protected checkIsClickedOnAnnotationInternal

  • checkIsClickedOnAnnotationInternal(x: number, y: number): boolean

checkIsPointWithinClipArea

  • checkIsPointWithinClipArea(mousePoint: Point): boolean

checkIsWithinBounds

click

  • Called internally. Send a click to the annotation if the point is in bounds, raising the clicked event and optionally selecting the annotation.

    Parameters

    Returns boolean

clickToSelect

Protected convertCartesianToPolar

  • convertCartesianToPolar(x: number, y: number): { x: number; y: number }
  • For Polar surface converts Cartesian Coordinates to Polar, otherwise returns the original values

    Parameters

    • x: number
    • y: number

    Returns { x: number; y: number }

    • x: number
    • y: number

Protected convertFromCoordinate

Protected convertPolarToCartesian

  • convertPolarToCartesian(x: number, y: number, isDomAnnotation?: boolean): { x: number; y: number }
  • For Polar surface converts Polar Coordinates to Cartesian, otherwise returns the original values

    Parameters

    • x: number

      is always angle for Polar

    • y: number

      is always radius for Polar

    • Default value isDomAnnotation: boolean = false

    Returns { x: number; y: number }

    • x: number
    • y: number

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 deleteAdorner

  • deleteAdorner(): void

Protected drawBackground

  • drawBackground(renderContext: WebGlRenderContext2D, textWidth: number, textHeight: number, baselineHeight: number, position: Point, clipRect: Rect): void
  • Parameters

    Returns void

drawWithContext

Protected getAbsoluteCoordinates

Protected getAbsoluteHorizontalCoordinate

  • getAbsoluteHorizontalCoordinate(value: number): number

Protected getAbsoluteVerticalCoordinate

  • getAbsoluteVerticalCoordinate(value: number): number

getAdornerAnnotationBorders

  • getAdornerAnnotationBorders(ordered?: boolean, applyDelta?: boolean): { x1: number; x2: number; y1: number; y2: number }
  • Returns annotation borders for the AdornerLayer which has the size of the whole canvas

    Parameters

    • Default value ordered: boolean = false

      flag to return x and y values in ascending order

    • Default value applyDelta: boolean = false

    Returns { x1: number; x2: number; y1: number; y2: number }

    • x1: number
    • x2: number
    • y1: number
    • y2: number

getAnnotationBorders

  • getAnnotationBorders(ordered?: boolean, applyDelta?: boolean): { x1: number; x2: number; y1: number; y2: number }
  • inheritdoc

    Parameters

    • Default value ordered: boolean = false
    • Default value applyDelta: boolean = false

    Returns { x1: number; x2: number; y1: number; y2: number }

    • x1: number
    • x2: number
    • y1: number
    • y2: number

getAnnotationGripSvg

  • getAnnotationGripSvg(x: number, y: number): string
  • Get svg for the adorner grip handles for standard annotations

    Parameters

    • x: number
    • y: number

    Returns string

Protected getClipPath

getClippingRect

Protected getCoordinate

getRenderLayer

  • getRenderLayer(): number
  • The render layer grouping within which the annotation will be draw. Defaults to EDefaultRenderLayer.AnnotationsAboveSeriesLayer

    Returns number

getRenderNextTo

getRenderOrder

  • getRenderOrder(): number

Protected getResolvedCoordinate

getRotationCenter

  • getRotationCenter(x: number, y: number, bounds: TSRTextBounds): Point
  • Calculate the center point for a rotation

    Parameters

    • x: number
    • y: number
    • bounds: TSRTextBounds

    Returns Point

getSurfaceRenderOrder

  • getSurfaceRenderOrder(): number
  • Allows an annotation to be treated as if it was drawn on a surface with a different draw order than its actual parent surface

    Returns number

Protected getValue

Protected getValuesFromCoordinates

  • getValuesFromCoordinates(point: Point, translateToSeriesViewRect: boolean): Point

Protected getX1Coordinate

Protected getX2Coordinate

Protected getXYCoordinatesFromValues

  • getXYCoordinatesFromValues(xyDataPoint: Point): Point

Protected getY1Coordinate

Protected getY2Coordinate

hover

linkAxes

  • linkAxes(): void

Protected notifyPropertyChanged

  • notifyPropertyChanged(propertyName: string): void

onAttach

onDetach

  • onDetach(): void

onDpiChanged

onDragAdorner

onDragEnded

  • onDragEnded(): void

onDragStarted

resumeInvalidate

  • resumeInvalidate(): void
  • Internal use. If isHidden,x1,y1 have change since suspendInvalidate was called, call invalidateParent

    Returns void

Protected setAnnotationBorders

  • setAnnotationBorders(x1: number, x2: number, y1: number, y2: number): void
  • Sets annotationBorders For renderContext annotations it is scaled and for SVG annotations it is not For example if we have a macbook with retina display and canvas.width = 1600px, canvas.height = 1200px, canvas.style.width = 800px, canvas.style.height = 600px If we have BoxAnnotation (renderContext) which takes 50% width and height, located in the left-top corner it should have annotationBorders as follows x1 = 0, x2 = 800, y1 = 0, y2 = 600 But if we have CustomAnnotation (SVG) which takes 50% width and height, located in the left-top corner it should have annotationBorders as follows x1 = 0, x2 = 400, y1 = 0, y2 = 300

    Parameters

    • x1: number
    • x2: number
    • y1: number
    • y2: number

    Returns void

setRenderLayer

  • The render layer grouping within which the series will be draw. Defaults to EDefaultRenderLayer.AnnotationsAboveSeriesLayer

    Parameters

    Returns void

setRenderNextTo

setRenderOrder

  • setRenderOrder(value: number): void

setSurfaceRenderOrder

  • setSurfaceRenderOrder(value: number): void
  • Allows an annotation to be treated as if it was drawn on a surface with a different draw order than its actual parent surface

    Parameters

    • value: number

    Returns void

suspendInvalidate

  • suspendInvalidate(): void
  • Internal use. Captures the state of isHidden,x1,y1 and prevents invalidateParent being called on change to these properties

    Returns void

svgStringAdornerTemplate

  • svgStringAdornerTemplate(x1: number, y1: number, x2: number, y2: number): string

toJSON

Protected updateAdornerInner

  • updateAdornerInner(): void

Object literals

Protected annotationBorders

annotationBorders: object

the annotation absolute coordinates

x1

x1: number = 0

x2

x2: number = 0

y1

y1: number = 0

y2

y2: number = 0

Generated using TypeDoc