canvas-gui
    Preparing search index...

    Class CvsRanger

    A slider with two draggable thumbs

    This control has 2 thumbs that can be dragged along a track. The thumbs' positions represent a low and high value both within user defined limits.

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

    Hierarchy (View Summary)

    Index

    Properties

    _inset: number
    _limit0: number
    _limit1: number
    _majorTicks: number
    _majorTickSize: number
    _minorTicks: number
    _minorTickSize: 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.

      Parameters

      • child: any

        is the actual control or its id

      • Optionalrx: number
      • Optionalry: number

      Returns any

      this control

    • Execute one or more configuration methods on this control.

      The parameter is a user defined object where each field is the name of a configuration method and its value is the method's parameter(s). Multiple parameters should be in an array and use 'undefined' if the method expects no parameters.

      This object will change the color scheme, text size and alignment, it will also make sure it is visible.

      { scheme : 'red', textSize : 12, textAlign: ['left', 'top'], show : undefined }
      
      If the field name does not exist or not a valid function of this control it will be silently ignored.

      There is no error checking on the parameters, it is up to the user to ensure they are valid for the control method.

      Parameters

      • cfg: any

        the configuration object

      Returns CvsRanger

      this control

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

      Parameters

      • ...c: any

        valid radii combination

      Returns number[] | CvsControl

      an array of the currently used radii values

    • Disables this control.

      Parameters

      • Optionalcascade: boolean

        if true disable child controls

      Returns CvsControl

      this control

    • Enables this control.

      Parameters

      • Optionalcascade: boolean

        if true enable child controls

      Returns CvsControl

      this control

    • Make this control invisible.

      Parameters

      • Optionalcascade: boolean

        if true hide any children

      Returns CvsControl

      this control

    • Returns number

      the high value of the range

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

      Parameters

      • value: number

        value to test

      Returns boolean

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

    • Set the lower and upper limits for the slider

      Parameters

      • l0: number

        lower limit

      • l1: number

        upper limit

      Returns CvsSlider

      this slider object

    • Returns number

      the low value of the range

    • Move this control relative to current position.

      Parameters

      • x: number

        horizontal distance

      • y: number

        vertical distance

      Returns CvsRanger

      this control

    • Move this control to an absolute position.

      Parameters

      • x: number

        horizontal position

      • y: number

        vertical position

      Returns CvsRanger

      this control

    • 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 (default value).

      Parameters

      • alpha: number = 255

        alpha value for controls background color.

      Returns CvsControl

      this control

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

      Parameters

      • dir: string = 'east'

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

      Returns CvsControl

      this control

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

      Parameters

      • parent: any

        is the parental control or its id

      • Optionalrx: number

        x position relative to parent

      • Optionalry: number

        y position relative to parent

      Returns CvsPin

      this control

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

      Parameters

      • Optionalv0: number

        low value

      • Optionalv1: number

        high value

      Returns Object | CvsControl

      this control or the low/high values

    • Remove a child control from this one so that it stays in same screen position.

      Parameters

      • child: any

        the control to remove or its id

      Returns CvsRanger

      this control

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

      Parameters

      • Optionalname: string

        the color scheme name e.g. 'blue'

      • Optionalcascade: boolean

        if true propogate scheme to all child controls.

      Returns ColorScheme | CvsControl

      this control or the control's color scheme

    • 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

      Parameters

      • event_handler: Function

        the function to handle this control's events.

      Returns CvsRanger

      this control

    • An alternative to the enable / disable methods.

      Parameters

      • enable: boolean

        true / false

      • Optionalcascade: boolean

        true apply to all children

      Returns CvsPin

      this control

    • An alternative to the show / hide methods.

      Parameters

      • visible: boolean

        true / false

      • Optionalcascade: boolean

        if true hide children

      Returns CvsPin

      this control

    • Make this control visible.

      Parameters

      • Optionalcascade: boolean

        if true then show any children

      Returns CvsControl

      this control

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

      Parameters

      • major: number

        the number of major domains on the track

      • minor: number

        the number of minor domains between major ticks

      • Optionalstick2ticks: boolean

        slider value is constrainged to tick values

      Returns CvsControl

      this slider object

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

      Parameters

      • Optionaltsize: number

        text size for this tooltip

      Returns CvsRanger

    • Create a tooltip for this control.

      Parameters

      • tiptext: string

        the text to appear in the tooltip

      Returns CvsRanger

      this control

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

      Parameters

      • Optionalv0: number

        value to set the first thumbs.

      • Optionalv1: number

        value to set the second thumbs.

      Returns number[] | CvsControl

      an array of the current values or this ranger object.

    • Gets or sets the thickness of the track.

      The thickness is constrained to the range ≥ 4 and ≤ 0.1 * control width.

      Parameters

      • tWgt: number

        the required track thickness)

      Returns number | CvsControl

      the curent track thickness or this control