The Application Object: 1.4 GenApplication Basics: Attach and Launch Flags

| Up: GEOS SDK TechDocs | Up | Prev: 1.3 Application Instance Reference | Next: 1.5 ApplicationStates 
GAI_launchFlags, GAI_attachFlags, MSG_GEN_APPLICATION_GET_LAUNCH_FLAGS, MSG_GEN_APPLICATION_GET_ATTACH_FLAGS

GAI_ launchFlags stores flags that are passed when the application is first launched. These flags are never set within your object declaration but may be passed with other messages.

ALF_SEND_LAUNCH_REQUEST_TO_UI_TO_HANDLE
If this bit is set, the application will not immediately be launched but will instead wait for the UI to launch it. This flag should not be set by the application itself; it is only used by UserLoadApplication() .
ALF_OPEN_IN_BACK
If this bit is set, the application will be opened behind other applications, in an inactive state. This flag is only used with MSG_GEN_PROCESS_OPEN_APPLICATION .
ALF_DESK_ACCESSORY
If this bit is set, the application will be treated as a "desk accessory," in a layer above normal applications.
ALF_DO_NOT_OPEN_ON_TOP
If this bit is set, the application will be prevented from both gaining the focus and opening on top of other applications.
ALF_OVERRIDE_MULTIPLE_INSTANCE
If this bit is set, and UILM_MULTIPLE_INSTANCES is also set as the application's UILaunchModel , the application will not query the user if he or she attempts to initiate multiple instances of the same application; the application will be multiply launched without first checking whether the already running application should be used instead.
ALF_OPEN_FOR_IACP_ONLY
If this bit is set, the application will be opened only to facilitate a connection with IACPConnect() ; the application should close once that task is completed. If the application should remain open after such an IACP connection, this bit should be cleared. This behavior is used only for MSG_GEN_PROCESS_OPEN_APPLICATION connections. The application cannot be opened in engine mode.

GAI_ attachFlags stores flags related to an application attaching from a state file. These flags are never set within your object declaration but may be passed with other messages.

AAF_RESTORING_FROM_STATE
If this bit is set, the application was launched via MSG_GEN_PROCESS_RESTORE_FROM_STATE . AAF_STATE_FILE_PASSED will also be set.
AAF_STATE_FILE_PASSED
If this bit is set, the application is being restored from a state file.
AAF_DATA_FILE_PASSED
If this bit is set, a data file containing much of the instance data of the application (of type AppLaunchBlock ) is being passed to the launching message. This is internal and should not be used.
AAF_RESTORING_FROM_QUIT
If this bit is set, the application was in the process of quitting, reached engine mode, and is now being started up into application mode again before completely exiting. If set, then AAF_RESTORING_FROM_STATE will also be set. This bit ensures that certain clean-up operations that are done before an application is quit are un-done, and that the application returns to its former state.

MSG_GEN_APPLICATION_GET_LAUNCH_FLAGS

AppLaunchFlags MSG_GEN_APPLICATION_GET_LAUNCH_FLAGS();

This message retrieves the contents of the GenApplication's GAI_launchFlags field.

Source: Rarely used.

Destination: Any GenApplication object.

Parameters: None.

Return: The AppLaunchFlags record stored in GAI_launchFlags .

Interception: Do not intercept.

MSG_GEN_APPLICATION_GET_ATTACH_FLAGS

AppAttachFlags MSG_GEN_APPLICATION_GET_ATTACH_FLAGS();

This message retrieves the contents of the GenApplication's GAI_attachFlags field.

Source: Rarely used.

Destination: Any GenApplication object.

Parameters: None.

Return: The AppAttachFlags stored in GAI_attachFlags .

Interception: Do not intercept.

| Up: GEOS SDK TechDocs | Up | Prev: 1.3 Application Instance Reference | Next: 1.5 ApplicationStates