This function defines a reference window for the VaToolBxCenterWindow function.
When a reference window is defined, centering is relative to the position of this window, not to the main monitor. The reference window must exist and be visible.
It is possible to return to the default behavior (centering on desktop) by passing the reserved word *NULL_OBJECT as parameter.
Important: the DLL VaToolBx must be loaded (LOAD_DLL instruction) when the VaToolBxSetRefWindow function is called and it must remain loaded for the VaToolBxCenterWindow function calls.
Context
Windows client.
Mobile client,
Adelia Cloud client.
Parameters
<WINDOW> |
Window name. |
Example
/* centering of window ID_WIN1 relative to window ID_WIN0
CALL_DLL 'VATOOLBX.DLL' 'VaToolBxSetRefWindow' ID_WIN0
CALL_DLL 'VATOOLBX.DLL' 'VaToolBxCenterWindow' ID_WIN1
/* reset centering on desktop
CALL_DLL 'VATOOLBX.DLL' 'VaToolBxSetRefWindow' *NULL_OBJECT
List of the VaToolBx functions by topic