Class CvsRanger

This class represents a slider with 2 draggable thumbs to define a value within user defined limits.

Major and minor tick marks can be added to the bar and supports stick-to-ticks if wanted.

Hierarchy

Properties

_inset: number
_limit0: number
_limit1: number
_majorTickSize: number
_majorTicks: number
_minorTickSize: number
_minorTicks: number
_s2ticks: boolean
_t01: number
_thumbCnrs: number[]
_thumbSize: number
_trackWeight: number

Accessors

  • get id(): string
  • The unique identifier for this control.

    Returns string

  • get isEnabled(): boolean
  • This is true if the control can respond to UI events else false.

    Use enable() and disable() to enable and disable it.

    Returns boolean

  • get isOpaque(): boolean
  • This is true if the control background is opaque else false.

    Use opaque() and transparent() display / hide the background.

    Returns boolean

  • get isVisible(): boolean
  • This is true if the control is visible else false.

    Use hide() and show() to set visibility.

    Returns boolean

  • get type(): string
  • The type name for this control.
    (type name = class name without the Cvs prefix)

    Returns string

Methods

  • Add a child to this control using its relative position [rx, ry]. If rx and ry are not provided then it uses the values set in the child.

    Returns

    this control

    Parameters

    • c: string | CvsBaseControl

      is the actual control or its id

    • Optional rx: number
    • Optional ry: number

    Returns any

  • Get or set the corner radii used for this control.

    To set the radii the parameters must be one of the following

    • an array of 4 numbers.
    • a comma seperated list of 4 numbers.
    • a single number to be used for all 4 radii.

    If no parameter is passed or does not match one of the above then an array of the currently used radii values.

    Returns

    an array of the currently used radii values

    Parameters

    • Rest ...c: any

      valid radii combination

    Returns number[] | CvsBaseControl

  • Disables this control.

    Returns

    this control

    Parameters

    • Optional cascade: boolean

      if true disable child controls

    Returns CvsBaseControl

  • Enables this control.

    Returns

    this control

    Parameters

    • Optional cascade: boolean

      if true enable child controls

    Returns CvsBaseControl

  • Make this control invisible.

    Returns

    this control

    Parameters

    • Optional cascade: boolean

      if true hide children

    Returns CvsBaseControl

  • Returns

    the high value of the range

    Returns number

  • Checks whether a value is between the lower and upper limits for this control. It allows the user to prevalidate a value before attempting to change the control's value.

    Returns

    true if the value lies within the control's limits else false

    Parameters

    • value: number

      value to test

    Returns boolean

  • Set the lower and upper limits for the slider

    Returns

    this slider object

    Parameters

    • l0: number

      lower limit

    • l1: number

      upper limit

    Returns CvsSlider

  • Returns

    the low value of the range

    Returns number

  • Move this control relative to current position.

    Returns

    this control

    Parameters

    • x: number

      horizontal distance

    • y: number

      vertical distance

    Returns CvsRanger

  • Move this control to an absolute position.

    Returns

    this control

    Parameters

    • x: number

      horizontal position

    • y: number

      vertical position

    Returns CvsRanger

  • Makes the controls background opaque. The actual color depends on the controls color scheme.

    The second parameter, alpha, is optional and controls the level of opaqueness from 0 - transparent to 255 - fully opaque (efault value).

    Returns

    this control

    Parameters

    • alpha: number = 255

      alpha value for controls background color.

    Returns CvsBaseControl

  • Sets this controls display orientation to one of the four cardinal compass points. An invalid parameter will set the orientation to 'east' which is the default value.

    Returns

    this control

    Parameters

    • dir: string = 'east'

      'north', 'south', 'east' or 'west'

    Returns CvsBaseControl

  • Adds this control to another control which becomes its parent.

    Returns

    this control

    Parameters

    • parent: string | CvsBaseControl

      is the parental control or its id

    • Optional rx: number

      x position relative to parent

    • Optional ry: number

      y position relative to parent

    Returns CvsBaseControl

  • Sets or gets the low and high thumb values for this control. If both parameters are within the ranger limits then they are accepted and the thumbs are moved to the correct position.

    If either of the parameters are invalid then they are ignored and the method returns the current range low and high values.

    Returns

    this control or the low/high values

    Parameters

    • Optional v0: number

      low value

    • Optional v1: number

      high value

    Returns Object | CvsBaseControl

  • If the name of a valid color scheme is provided then it will use it to display the control, non-existant scheme names will be ignored. In both cases this control is returned.

    If there is no parameter it returns the name of the current color scheme used by this control.

    Returns

    this control or the control's color scheme

    Parameters

    • Optional name: string

      the color scheme name e.g. 'blue'

    • Optional cascade: boolean

      if true propogate scheme to all child controls.

    Returns ColorScheme | CvsBaseControl

  • This sets the event handler to be used when this control fires an event. The parameter can take one of three forms:

    1. Arrow function definition
    2. Anonymous function definition
    3. Named function declaration

    Returns

    this control

    Parameters

    • event_handler: Function

      the function to handle this control's events.

    Returns CvsRanger

  • Make this control visible.

    Returns

    this control

    Parameters

    • Optional cascade: boolean

      if true show children

    Returns CvsBaseControl

  • Shrink the control to fit contents.

    To shrink on one dimension only pass either 'w' (width) or 'h' (height) to indicate which dimmension to shrink

    Returns

    this control

    Parameters

    • Optional dim: string

      the dimension to shrink

    Returns CvsBaseControl

  • The track can be divided up into a number of domains separated with major ticks. The major domains and be further divided into subdomains separated with minor ticks. If the final parameter is true then values returned by the slider are consrained to the tick values.

    Returns

    this slider object

    Parameters

    • major: number

      the number of major domains on the track

    • minor: number

      the number of minor domains between major ticks

    • Optional stick2ticks: boolean

      slider value is constrainged to tick values

    Returns CvsBaseControl

  • Sets the size of the text to use in the tooltip.

    Parameters

    • Optional tsize: number

      text size for this tooltip

    Returns CvsRanger

  • Create a tooltip for this control.

    Returns

    this control

    Parameters

    • tiptext: string

      the text to appear in the tooltip

    Returns CvsRanger

  • If the parameter value is withing the slider limits it will move the thumb to the appropriate position. If no parameter is passed or is outside the limits this methods returns the current slider value.

    Returns

    the current value or this slider object

    Parameters

    • Optional value: number

      the selected value to be set

    Returns number | CvsBaseControl

  • If both parameter values are within the ranger's limits it will move the thumbs to the appropriate positions. If no parameters are passed or if either is outside the ranger's limits this methods returns the an array containing the current ranger values.

    Returns

    an array of the current values or this ranger object.

    Parameters

    • Optional v0: number

      value to set the first thumbs.

    • Optional v1: number

      value to set the second thumbs.

    Returns number[] | CvsBaseControl

  • Gets or sets the thickness of the track.

    If there is no parameter the currect track thickness is returned. Any other value is constrained to the range ≥ 4 and ≤ 0.1 * control width.

    Returns

    the curent track thickness or this control

    Parameters

    • tWgt: number

      the required track thickness)

    Returns number | CvsBaseControl

Generated using TypeDoc