Empty UiElement

Hierarchy

Properties

origin: Point = ...
position: Point = ...

Pixel location of UiElements origin. To get position use getPosition(relativePosition).

Coordinate system = position scale (UIElement.scale)

renderingScale: LinearScaleXY
scale: ScaleXY<ViewportScale1D>
size: Point = ...

Accessors

  • get draggable(): boolean
  • Returns boolean

  • set draggable(state: boolean): void
  • Parameters

    • state: boolean

    Returns void

Methods

  • 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 EmptyUIElement

  • Get auto dispose behavior for this UI element.

    Returns

    Auto dispose mode.

    Returns AutoDisposeMode

  • Get dragging mode of object. Defines how the object can be dragged by mouse.

    Returns

    Object itself

    Returns UIDraggingModes

  • Get theme effect enabled on component or disabled.

    A theme can specify an Effect to add extra visual oomph to chart applications, like Glow effects around data or other components. Whether this effect is drawn above a particular component can be configured using the setEffect method.

     // Example, disable theme effect from a particular component.
    Component.setEffect(false)

    For the most part, theme effects are enabled by default on most components.

    Theme effect is configured with effect property.

    Returns

    Boolean that describes whether drawing the theme effect is enabled around the component or not.

    Returns boolean

  • Get margin around object in pixels.

    Returns

    Margin datastructure

    Returns Margin

  • Get mouse style.

    Returns

    Interface for defining how mouse should look when hovering over UI object

    Returns UIMouseStyle

  • Get the position origin of this UiElement. Affects how the "position" of UIElement is interpreted.

    Returns

    Vec2 with each plane in range [-1, 1], where 0 is middle

    Returns Point

  • Returns

    Mouse interactions state

    Returns boolean

  • Returns the position of this UiElement at given location relative to elements size.

    Returns

    Object itself for fluent itself

    Parameters

    • relativePosition: Point = ...

      Relative position vector (-1 to 1 which specifies position of origin, 0 is center of the object)

    • spaceOfInterest: UISpace = UISpace.Everything

      Parameter to disregard parts of object when calculating the asked position. Defaults to Margin, which includes everything. Should only ever be necessary for other UiElements

    Returns Point

  • Returns the size of the UiElements in pixels including any Margins or Paddings

    Returns

    Object size in pixels

    Parameters

    • spaceOfInterest: UISpace = UISpace.Everything

      Parameter to disregard parts of object when calculating the position. Defaults to Margin, which includes everything. Should only ever be necessary for sub-classes

    Returns Point

  • 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

  • Type Parameters

    Parameters

    Returns void

  • Set auto dispose behavior for this UI element.

    Can be used to set a condition, where the UI element is automatically disposed, removing it from view.

     // Example, remove UI element when it is larger than 20% of viewport.
    UIElement.setAutoDispose({
    type: 'max-width',
    maxWidth: 0.20,
    })

    Returns

    Object itself for fluent interface.

    Parameters

    Returns EmptyUIElement

  • Member function that updates the size of the UI elements contents. UiElements should apply this inside 'update'

    Parameters

    • sizeInPixels: Point

      Size of element in pixels

    Returns void

  • Set dragging mode of object. Defines how the object can be dragged by mouse.

    See UIDraggingModescollection for options.

    Returns

    Object itself

    Parameters

    • draggingMode: UIDraggingModes = UIDraggingModes.notDraggable

      DraggingMode or undefined to disable dragging

    Returns EmptyUIElement

  • Set theme effect enabled on component or disabled.

    A theme can specify an Effect to add extra visual oomph to chart applications, like Glow effects around data or other components. Whether this effect is drawn above a particular component can be configured using the setEffect method.

     // Example, disable theme effect from a particular component.
    Component.setEffect(false)

    For the most part, theme effects are enabled by default on most components.

    Theme effect is configured with effect property.

    Returns

    Object itself.

    Parameters

    • enabled: boolean

      Theme effect enabled

    Returns EmptyUIElement

  • Set margin around object in pixels.

    Returns

    Object itself

    Parameters

    • margin: number | Partial<MMargin>

      Number with pixel margins for all sides or datastructure with individual pixel margins for each side. Any side can be omitted, only passed values will be overridden.

    Returns EmptyUIElement

  • Set mouse style when hovering over UI object.

    Returns

    Object itself

    Parameters

    • mouseStyle: UIMouseStyle

      Interface for defining how mouse should look when hovering over UI object

    Returns EmptyUIElement

  • Sets the position origin of this UiElement. Affects how the "position" of UIElement is interpreted.

    See UIOrigins for a collection of common arguments in an easy-to-read format.

    Returns

    Object itself

    Parameters

    Returns EmptyUIElement

  • Set mouse interactions enabled or disabled

    Returns

    Object itself for fluent interface

    Parameters

    • state: boolean

      Specifies state of mouse interactions

    Returns EmptyUIElement

  • Sets the position of this UiElement relative to its origin.

    NOTE: UIElements scale can't be changed apart from when it is created.

    Returns

    Object itself

    Parameters

    • position: Point

      Location on the UIElements scale, where its origin should be positioned

    Returns EmptyUIElement

  • Set element visibility.

    Returns

    Object itself.

    Parameters

    • state: boolean

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

    Returns EmptyUIElement