Options
All
  • Public
  • Public/Protected
  • All
Menu

Interface IDraggingParameterApi

Hierarchy

Index

Properties

hidden: boolean
id: string
name: string
sessionValue: string

The value that corresponds to the latest successful call to ISessionApi.customize. This property will be updated immediately before ISessionApi.customize returns.

value: string

The current value.

Validation happens immediately when setting this property. An error will be thrown in case validation fails. Use isValid to test whether a value passes validation.

In case ISessionApi.automaticSceneUpdate is true, setting the value will immediately trigger a customization (see ISessionApi.customize).

choices?: string[]
decimalplaces?: number
defval?: string
displayname?: string
draggingColor?: string

The color of the objects when dragged. (default: '#0d44f0')

expression?: string
format?: string[]
group?: ResParameterGroup
hint?: string
hover?: boolean

If the objects are hoverable. (default: true)

hoverColor?: string

The color of the objects when hovered. (default: '#00ff78')

interval?: number
max?: number
min?: number
objects?: IDraggableObject[]

The objects that can be dragged.

For each object, the name filter, the restrictions, the drag anchors, and the drag origin can be defined. The name filter is used to filter the objects that can be dragged with the defined settings. This means that multiple objects can be dragged with different settings, but also multiple objects can be dragged with the same settings.

order?: number
prompt?: { activeText?: string; activeTitle?: string; inactiveTitle?: string }

A prompt that can be defined which is displayed instead of the default prompt.

Type declaration

  • Optional activeText?: string

    The text when the parameter is inactive.

  • Optional activeTitle?: string

    The title when the parameter is active.

  • Optional inactiveTitle?: string

    The title when the parameter is inactive.

restrictions?: RestrictionDefinition[]
settings?: object
structure?: ResStructureType
tooltip?: string
umax?: number
umin?: number
visualization?: PARAMETER_VISUALIZATION
vmax?: number
vmin?: number

Methods

  • isValid(value: unknown, throwError?: boolean): boolean
  • Evaluates if a given value is valid for this parameter.

    Parameters

    • value: unknown

      the value to evaluate

    • Optional throwError: boolean

      if true, an error is thrown if validation does not pass (default: false)

    Returns boolean

  • resetToDefaultValue(): void
  • Resets the value to the default value.

    Returns void

  • resetToSessionValue(): void
  • Resets the value to sessionValue.

    Returns void

  • stringify(value?: unknown): string
  • Returns the current value as a string, or attempts to stringify a given value if provided.

    Parameters

    • Optional value: unknown

      the value to stringify

    Returns string