OEM User's Guide

OEM External Specification
OEM User’s Guide—520330-001
A-31
Client Callback API (OEM to Client Application)
Width
Use the Width method to inform the client application to adjust the width of its display
window to the new value.
Parameters
NewWidth (input)
is the new width of the window.
Return Value
•
0 if the client has accepted and handled the request
•
Non-zero if the client cannot or will not process the request
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 client application determines which window should be adjusted. It might be the
main window for the application, or it might be a subordinate window that is responsible
for displaying information relevant to the framework or callback object. This is a request
only; the client can choose not to adjust the window width if necessary (for example, if
the user has already explicitly set the width of the window).
The OEM Gateway evaluates the return value only as zero or non-zero. A zero return
value from the call indicates that the client has accepted the command, and a non-zero
value indicates the client cannot or will not process the command. It is important that
client applications return the appropriate value, because the OEM Gateway might
behave differently based on the outcome of the call.
If the client application’s WindowManagementEnabled function returns False, this
method is not called by the OEM.
Example
Dim RC As Integer
' ClientCallbackObject was passed in a Popup.Add or Object.Add
call
' Assume FrameworkWindow is defined elsewhere in the OEM
RC = ClientCallbackObject.Width(FrameworkWindow.Width / 2)
In this example, the OEM Gateway has requested that the client adjust the width of its
window to be half the width of the framework window.
Function Height(NewWidth As Single) As Integer