Version: 7.9

system.gui

GUI Functions

The following functions allow you to control windows and create popup interfaces.

📄️ system.gui.chooseColor

Prompts the user to pick a color using the default color-chooser dialog box.

📄️ system.gui.closeDesktop

Allows you to close any of the open desktops associated with the current client.

📄️ system.gui.color

Creates a new color object, either by parsing a string or by having the RGB[A] channels specified explicitly.

📄️ system.gui.confirm

Displays a confirmation dialog box to the user with Yes and No options, and a custom message.

📄️ system.gui.convertPointToScreen

Converts a pair of coordinates that are relative to the upper-left corner of some component to be relative to the upper-left corner of the entire screen.

📄️ system.gui.createPopupMenu

Creates a new popup menu, which can then be shown over a component on a mouse event.

📄️ system.gui.desktop

Allows for invoking system.gui functions on a specific desktop.

📄️ system.gui.errorBox

Displays an error-style message box to the user.

📄️ system.gui.findWindow

Finds and returns a list of windows with the given path.

📄️ system.gui.getCurrentDesktop

Returns the handle of the desktop this function was called from.

📄️ system.gui.getDesktopHandles

Gets a list of all secondary handles of the open desktops associated with the current client.

📄️ system.gui.getOpenedWindowNames

Finds all of the currently open windows, returning a tuple of their paths.

📄️ system.gui.getOpenedWindows

Finds all of the currently open windows, returning a tuple of references to them.

📄️ system.gui.getParentWindow

Finds the parent (enclosing) window for the component that fired an event, returning a reference to it.

📄️ system.gui.getQuality

Returns the data quality for the property of the given component as an integer.

📄️ system.gui.getScreens

Get a list of all the monitors on the computer this client is open on.

📄️ system.gui.getSibling

Given a component event object, looks up a sibling component.

📄️ system.gui.getWindow

Finds a reference to an open window with the given name.

📄️ system.gui.getWindowNames

Returns a list of the paths of all windows in the current project, sorted alphabetically.

📄️ system.gui.inputBox

Opens up a popup input dialog box.

📄️ system.gui.isTouchscreenModeEnabled

Checks whether or not the running client's touchscreen mode is currently enabled.

📄️ system.gui.messageBox

Displays an informational-style message popup box to the user.

📄️ system.gui.openDesktop

Creates an additional Desktop in a new frame.

📄️ system.gui.openDiagnostics

Opens the client runtime diagnostics window, which provides information regarding performance, logging, active threads, connection status, and the console.

📄️ system.gui.passwordBox

Pops up a special input box that uses a password field, so the text isn't echoed back in clear-text to the user.

📄️ system.gui.setScreenIndex

Moves an open client to a specific monitor.

📄️ system.gui.setTouchscreenModeEnabled

Alters a running client's touchscreen mode on the fly.

📄️ system.gui.showNumericKeypad

Displays a modal on-screen numeric keypad, allowing for arbitrary numeric entry using the mouse, or a finger on a touchscreen monitor.

📄️ system.gui.showTouchscreenKeyboard

Displays a modal on-screen keyboard, allowing for arbitrary text entry using the mouse, or a finger on a touchscreen monitor.

📄️ system.gui.transform

Sets a component's position and size at runtime.

📄️ system.gui.warningBox

Displays a message to the user in a warning style pop-up dialog.

Functions by Scope

Constants

system.gui.ACCL_NONE = 0
system.gui.ACCL_CONSTANT = 1
system.gui.ACCL_FAST_TO_SLOW = 2
system.gui.ACCL_SLOW_TO_FAST = 3
system.gui.ACCL_EASE = 4
system.gui.COORD_SCREEN = 0
system.gui.COORD_DESIGNER = 1

GUI Functions​