hiSetDBoxDefaultLocation

hiSetDBoxDefaultLocation(
l_location
[ g_autoUpdate { t | nil } ]
)
=> t / nil

Description

Sets the default location for all dialog boxes created with hiDisplayAppDBox, hiDisplayUserDBox, hiDisplayProgressBox, and hiDisplayFileDialog. This setting is used if the l_location argument of those functions has not been set or has been set incorrectly.

If both this function and the l_location argument of a dialog box function has been set, the l_location argument is used. If neither has been set, the location is determined by the underlying toolkit that implements the dialog box and is usually the center of the screen.

Argument

l_location

The location of the dialog box on the screen, specified as the x and y coordinates of the upper left corner of the dialog box:

list(x-coordinate y-coordinate)

g_autoUpdate

When set to t, each time a dialog box created using a HI function is moved from its default location to a new location, the default location of the dialog box is updated to the new location automatically. The new location that is saved is the position of the dialog box when it is dismissed. The default is nil.

Value Returned

`t`	The default location was set.
`nil`	There was an error.

Cadence User Interface SKILL Reference
Product Version IC23.1, September 2023