Defined in:Sets the input management mode.
||The new input management mode.|
SetInputManagementModefunction determines whether the Interface Manager modifies the current Input Manager mode when windows are created and destroyed. The
modeparameter can be one of the following constants.
||The Interface Manager does not change the Input Manager mode when windows are created and destroyed.|
||The Interface Manager automatically changes the Input Manager mode when windows are created and destroyed.|
kInputManagementAutomatic, then the Interface Manager sets the Input Manager mode to
kInputAllActivewhenever there are no windows visible that are capable of receiving user input. When there is at least one input-receiving window visible, the Interface Manager automatically sets the Input Manager mode to
kInputInactive, meaning that mouse and keyboard events are sent to the currently active window and are not processed by the Input Manager.
If the mode is
kInputManagementManual, then the Interface Manager does not modify the Input Manager mode regardless of whether input-receiving windows are visible.
A window is considered able to receive input if it does not have the
kWindowPassivewindow flag set (see the
The default input management mode when the engine starts up is