MGL_suspendAppFlagsType

Declaration

typedef enum {
MGL_DEACTIVATE = 0x0001,
MGL_REACTIVATE = 0x0002
} MGL_suspendAppFlagsType

Prototype In

mgraph.h

Description

Defines the suspend application callback flags, passed to the suspend application callback registered with the MGL. This callback is called when the user presses one of the system key sequences indicating that they wish to change the active application. The MGL will catch these events and if you have registered a callback, will call the callback to save the state of the application so that it can be properly restored when the user switches back to your application. The MGL takes care of all the details about saving and restoring the state of the hardware, and all your application needs to do is save its own state so that you can re-draw the application screen upon re-activation.

Note: Your application suspend callback may get called twice with the MGL_DEACTIVATE flag in order to test whether the switch should occur (under both DirectX and WinDirect fullscreen modes).

Note: When your callback is called with the MGL_DEACTIVATE flag, you cannot assume that you have access to the display memory surfaces as they may have been lost by the time your callback has been called.

Members

MGL_DEACTIVATE | Application losing active focus
MGL_REACTIVATE | Application regaining active focus

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com