OEM User's Guide

OEM External Specification
OEM User’s Guide—520330-001
A-27
Client Callback API (OEM to Client Application)
WindowManagementEnabled
The OEM Server uses the WindowManagementEnabled method to determine whether a
client application needs to receive window management callbacks (for example, tile
requests or minimize requests). The OEM queries this value for each client before
sending a window management notification. If a client will participate in window
management operations, this function should return True. If it will not participate in
window management operations, this function should return False.
Parameters
None
Return Value
•
True if the client will participate in window management operations
•
False if the client will not participate in window management operations
Considerations
This method is called by the OEM Gateway when the user or framework has invoked a
window management function (for example, Tile or Cascade). The OEM first queries
each client to determine whether that client will participate in the operation. For those
that do take part, the appropriate callback method (for example, Move or Height) is then
called.
To maintain compatibility with OEM version 1.0, the OEM Server assumes that each
client will accept window management notifications unless its
WindowManagementEnabled function returns False. As a result, a client application that
does not include this function in its callback class receives all window management
messages.
Example
Dim RC As Boolean
' ClientCallbackObject was passed in a Popup.Add or Object.Add
call
RC = ClientCallback.WindowManagementEnabled
If RC = True Then
' Send appropriate window management callback to the client
Function WindowManagementEnabled() As Boolean