Class ColorPickerWindow

A dropdown window that displays a Color Picker element to allow the user select a color.

Hierarchy (view full)

Constructors

constructor

Properties

_isRememberingPosition _rememberingPositionKey onCancelButtonPressed onConfirmButtonPressed lastPickerPosition previousWindowPositions windowContentPadding windowPadding

Accessors

colorPicker dpiScale getMaximumSize getMinimumSize height heightInPixels isDestroyed isFocused keyWindow left localShortcutContext parentWindow position renderWindow shortcutContext size top ui width widthInPixels

Methods

center close isVisible onActionTriggeredAccept onClose onDestroy onEditorUpdate onEditorUpdateLate onInitialize onVisibilityChanged onWindowDPIChanged onWindowFocusChanged onWindowResized screenToWindowPosition setMaximumSize setMinimumSize setPosition setPositionInPixels setSize setSizeInPixels temporaryWorkaroundMethod windowToScreenPosition construct constructInternal open

Events

onClosedCallback onFocusChangedInternal

Constructors

Protectedconstructor

Properties

Protected_isRememberingPosition

_isRememberingPosition: boolean

Protected_rememberingPositionKey

_rememberingPositionKey: string | Type

ProtectedonCancelButtonPressed

onCancelButtonPressed: (() => void)

Triggered when the user clicks the cancel button to close the window without confirming the picked color.

ProtectedonConfirmButtonPressed

onConfirmButtonPressed: (() => void)

Triggered when the user clicks the ok button to confirm its picked color.

StaticlastPickerPosition

lastPickerPosition: Immutable<Vector2>

The last position of the color picker. If set, it will be reused when the picker is spawned.

Protected Static ReadonlypreviousWindowPositions

previousWindowPositions: Map<string | Type, Immutable<Vector2>>

Static ReadonlywindowContentPadding

windowContentPadding: RectOffset

The default window content padding to be used for drop down windows.

Static ReadonlywindowPadding

windowPadding = 15

The default window padding to be used for drop down windows.

Accessors

colorPicker

dpiScale

  • get dpiScale(): number

  • Returns the DPI scale factor.

    Returns number

    Note

    The DPI scale is in relation to a 1x base resolution of 75 DPI.

getMaximumSize

getMinimumSize

height

  • get height(): number

  • Sets the height of the window in points.

    Returns number

  • set height(value): void

  • Parameters

    • value: number

    Returns void

heightInPixels

  • get heightInPixels(): number

  • Sets the height of the window in pixels.

    Returns number

  • set heightInPixels(value): void

  • Parameters

    • value: number

    Returns void

isDestroyed

  • get isDestroyed(): boolean

  • Check whether the window was destroyed.

    Returns boolean

isFocused

  • get isFocused(): boolean

  • Checks whether the window currently has keyboard focus.

    Returns boolean

  • set isFocused(value): void

  • Parameters

    • value: boolean

    Returns void

keyWindow

  • get keyWindow(): KeyWindowBase

  • Gets the key window which owns this window.

    Returns KeyWindowBase

left

  • get left(): number

  • Returns the X position of the window in screen coordinates in points.

    Returns number

localShortcutContext

  • get localShortcutContext(): ShortcutContext

  • Specifies the local shortcut context. This context will be automatically disabled whenever the user switches focus from the context.

    Returns ShortcutContext

parentWindow

position

  • get position(): Immutable<Vector2>

  • Determines the position in which the key window is, in screen coordinates.

    Returns Immutable<Vector2>

renderWindow

  • get renderWindow(): RenderWindow

  • Gets the RenderWindow associated with this EditorWindow.

    Returns RenderWindow

shortcutContext

  • get shortcutContext(): ShortcutContext

  • Specifies the global shortcut context. This context will be always enabled as long as the window is active.

    Returns ShortcutContext

size

top

  • get top(): number

  • Returns the X position of the window in screen coordinates in points.

    Returns number

ui

width

  • get width(): number

  • Sets the width of the window in points.

    Returns number

  • set width(value): void

  • Parameters

    • value: number

    Returns void

widthInPixels

  • get widthInPixels(): number

  • Sets the width of the window in pixels.

    Returns number

  • set widthInPixels(value): void

  • Parameters

    • value: number

    Returns void

Methods

center

  • center(): void

  • Centers the window within it's parent window.

    Returns void

close

isVisible

onActionTriggeredAccept

  • onActionTriggeredAccept(): void

  • Triggered when Escape button is pressed.

    Returns void

onClose

  • onClose(): void
  • Virtual

    Called whenever the user or the program requested to close the window.

    Returns void

ProtectedonDestroy

  • onDestroy(): void
  • Virtual

    Method to override to implement destruction of custom windows. Called by the engine before the window is destroyed.

    Returns void

ProtectedonEditorUpdate

  • onEditorUpdate(): void
  • Virtual

    Method to override to implement custom behavior of a window, called by the engine once per frame.

    Returns void

ProtectedonEditorUpdateLate

  • onEditorUpdateLate(): void
  • Virtual

    Method to override to implement custom behavior of a window, called by the engine once per frame, once all the windows had their onEditorUpdate() method called.

    Returns void

onInitialize

  • onInitialize(options): void
  • Virtual

    Method to override to implement initialization of custom windows. Called by the engine after window creation.

    Parameters

    Returns void

onVisibilityChanged

  • onVisibilityChanged(isVisible): void
  • Virtual

    Called whenever window visibility changed.

    Parameters

    • isVisible: boolean

    Returns void

    Note

    Implementing classes must call super.

onWindowDPIChanged

onWindowFocusChanged

  • onWindowFocusChanged(inFocus): void
  • Virtual

    Triggered whenever the window gains or loses focus.

    Parameters

    • inFocus: boolean

      True if focus was gained, false otherwise.

    Returns void

onWindowResized

  • onWindowResized(width, height): void
  • Virtual

    Triggered whenever the window size changes.

    Parameters

    • width: number

      New width of the window in pixels.

    • height: number

      New height of the window in pixels.

    Returns void

screenToWindowPosition

setMaximumSize

  • setMaximumSize(maxWidth, maxHeight): void

  • Defines the window maximum width and height in points.

    Parameters

    • maxWidth: number
    • maxHeight: number

    Returns void

setMinimumSize

  • setMinimumSize(minWidth, minHeight): void

  • Defines the window minimum width and height in points.

    Parameters

    • minWidth: number

      The minimum width of the window in points.

    • minHeight: number

      The minimum height of the window in points.

    Returns void

setPosition

  • setPosition(x, y): void

  • Moves the window on the desktop. Coordinates are in screen space using points.

    Parameters

    • x: number
    • y: number

    Returns void

setPositionInPixels

  • setPositionInPixels(x, y): void

  • Moves the window on the desktop. Coordinates are in screen space using pixels.

    Parameters

    • x: number
    • y: number

    Returns void

setSize

  • setSize(width, height): void

  • Resizes the window using a width and height in points.

    Parameters

    • width: number
    • height: number

    Returns void

setSizeInPixels

  • setSizeInPixels(width, height): void

  • Resizes the window using a width and height in pixels.

    Parameters

    • width: number
    • height: number

    Returns void

temporaryWorkaroundMethod

  • temporaryWorkaroundMethod(): void

  • Temporary workaround for ScriptDropDownWindow script interface generation that causes compilation issues due to missing methods.

    Returns void

windowToScreenPosition

Staticconstruct

  • construct<T>(type, keyWindow, dropdownOptions, anchorElement, anchorPosition, parentWindow?, windowOptions?): T

  • Opens a DropDownWindow of the specified type.

    Type Parameters

    Parameters

    • type: Type

      The type of the DropDownWindow to open.

    • keyWindow: KeyWindowBase

      The parent key window, if null, will use the current.

    • dropdownOptions: EnumValueTyped<DropDownWindowOption, number>

      The window options.

    • anchorElement: UIElementBase

      The optional element to anchor the drop down window.

    • anchorPosition: Immutable<Vector2>

      The optional anchor position. If anchorElement is not null, the value is relative to it, otherwise absolute.

    • OptionalparentWindow: EditorWindow

      Optional. A custom parent window of the drop down. Will use the parent from the anchor if null.

    • OptionalwindowOptions: any

      Optional. The window options that will be passed to onInitialize.

    Returns T

    The newly constructed DropDownWindow.

Protected StaticconstructInternal

Staticopen

  • open(initialColor, anchorElement?, position?): ColorPickerWindow

  • Creates a new window with the provided color displayed by the color picker.

    Parameters

    • initialColor: SRGBColor

      The color to be displayed at initialization.

    • OptionalanchorElement: UIElement

      Optional. A UI element to anchor this windo into.

    • Optionalposition: Vector2

      Optional. The optional anchor position. If anchorElement is not null, the value is relative to it, otherwise absolute.

    Returns ColorPickerWindow

Events

onClosedCallback

onClosedCallback: Event<[{
    isConfirming: boolean;
    pickedColor: SRGBColor;
}], void>

Triggered when the window closes, either with the intention to apply or cancel the last picked color.

ReadonlyonFocusChangedInternal

onFocusChangedInternal: Event<[boolean], void>

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods
Events