sys_active(STRING* title)
Returns a handle to the active window when it has changed or when its title contains a given string. Can be used to wait until a certain window or dialog becomes active.
Parameters:
title - STRING* or char*, part of the window title, or NULL for returning the handle only when the active window has changed.
Returns:
HWND of the active window when it either partially matches the given title, or has changed since the last sys_active call. Otherwise, NULL.
Speed:
Fast
Remarks:
- Normally the engine window is the active window, unless another application was started with exec or a Windows dialog became active.
Example:
See
sys_message.
See also:
exec, sys_message
► latest
version online