Draws a line freely on the chart. Pressing pointer down starts drawing while releasing it ends it.

Hierarchy

Constructors

Methods

  • Gets all data point values used to draw the line.

    Returns number[][]

    • An array consisting of an array of X-values and an array of Y-values.
  • Unsubscribes from the PointerDown event.

    Returns void

  • Unsubscribes from the PointerEnter event.

    Returns void

  • Unsubscribes from the PointerLeave event.

    Returns void

  • Unsubscribes from the PointerUp event.

    Returns void

  • Event that triggers when pointer is pressed down on top of the drawing tool.

    Parameters

    • handler: Handler<PointerDownEvent>

      Event handler containing the following parameters:

      -'xPosition' and 'yPosition' parameters return the current cursor position in axis values.

      -'xPositionClient' and 'yPositionClient' return the current cursor position in client coordinates (zero equals top-left corner).

      -'drawingTool' gets the drawing tool instance.

      -'button' indicates the pressed mouse button.

    Returns void

  • Event that triggers when pointer is moved onto the drawing tool.

    Parameters

    • handler: Handler<PointerEnterEvent>

      Event handler containing the following parameters:

      -'xPosition' and 'yPosition' parameters return the current cursor position in axis values.

      -'xPositionClient' and 'yPositionClient' return the current cursor position in client coordinates (zero equals top-left corner).

      -'drawingTool' gets the drawing tool instance.

    Returns void

  • Event that triggers when pointer is moved away from the drawing tool.

    Parameters

    • handler: Handler<PointerLeaveEvent>

      Event handler containing the following parameters:

      -'xPosition' and 'yPosition' parameters return the current cursor position in axis values.

      -'xPositionClient' and 'yPositionClient' return the current cursor position in client coordinates (zero equals top-left corner).

      -'drawingTool' gets the drawing tool instance.

    Returns void

  • Event that triggers when pointer is released on top of the drawing tool.

    Parameters

    • handler: Handler<PointerUpEvent>

      Event handler containing the following parameters:

      -'xPosition' and 'yPosition' parameters return the current cursor position in axis values.

      -'xPositionClient' and 'yPositionClient' return the current cursor position in client coordinates (zero equals top-left corner).

      -'drawingTool' gets the drawing tool instance.

      -'button' indicates the released mouse button.

    Returns void

  • Programmatically sets data points for the Freeform Line.

    Parameters

    • xValues: number[]

      Array of X-values for the data points.

    • yValues: number[]

      Array of Y-values for the data points.

    Returns void

  • Sets the color of the Freeform Line.

    Parameters

    • newColor: string

      New line color as string, should be in HEX format e.g. #FFFFFF.

    Returns void

  • Sets the width of the Freeform Line.

    Parameters

    • newWidth: number

      New line width.

    Returns void