company logo

ProjectContext :: initializeOptions - Initialize application options

The function initializes options provided by the applications options definition (default options dialog). The function reads all values from the option hierarchy. The option hierarchy is selected by the configuration (user) name passed to the function.

When no configuration name is passed, the configuration name is taken from the _CONFIG system variable. When this variable is not set, the configuration name is the login user name (BaseContext::userName()). When there is no configuration for the current user, the configuration name of the configuration set as current or default is used.

Notes:

When starting a GUI framework application, options are initialized from the database setting for the COMMON configuration and the configuration with the user's name or the name set in the _CONFIG variable. Additional calls to the function may overwrite the options set from previous calls. In order to reset an option, an empty option value might be passed.

Implementation details

ProjectContext  :: initializeOptions ( odaba::String &sConfiguration )
  • sConfiguration - Configuration name

    The configuration name is the name of the option list to be activated or being active. Often, the configuration name is the user or login name used to login into the system.