The current User Preference object holds the setting that are presently in place in a given G2 window.
To obtain the current User Preferences object:
Use the procedure gms-get-current preference.
Obtains the current User Preferences object for the G2 window referenced by handle.gms-get-current-preference(handle: integer)
->prefs: class gms-preferences
To create a new User Preferences object:
Clone a User Preferences object from the GMS palette to any workspace.
Use the create action to create an instance of gms-preferences programmatically.
To specify user preferences:
Edit attributes of the User Preferences object to specify the desired preferences.
Use the conclude action to specify the desired preferences programmatically.
After you create and customize a User Preferences object, you can specify that the preferences it specifies apply to an individual user. GMS binds a user to a Preferences Object via the user's login name.
To specify that a User Preferences object applies to a particular user:
Set the Gms-applicability of the object to be by-registration (the default).
Use gms-register-preferences-for-user to bind the preferences to the user:
gms-register-preferences-for-user
(prefs: class gms-preferences, user: symbol)
To specify that no User Preferences object applies to a particular user:
Call gms-register-preferences-for-user specifying prefs as gms-default-configuration and user as the login name of the user.
To specify a generic User Preferences object:
Set the Gms-applicability of the object to be default.
Gms-applicability is default. You can use the Gms-priority attribute to indicate the object GMS uses.
To indicate the User Preferences object to use when more than one exists:
Give the object a Gms-priority higher than that of any other User Preferences object.