ssCore.Win.setFocus

Makes the specified window the active window and gives it the input focus. If the window is minimized to the taskbar or the system tray it will be restored. If the window is hidden it will be made visible.


Availability:

First available in version 3.0 build 2039.


Input Parameters:

hwnd - [Optional] - Handle of the window that should receive the input focus. If the handle is not supplied or set to zero (0) then the current application window will get focus.


Output Parameters:

No output parameters.


Asynchronous Mode:

When this method is called asynchronously, a return object containing the output parameters is passed to the specified callback function.

ssCore.Win.setFocus( paramsObject [, callbackParamsObject] [, errorParamsObject] );


Synchronous Mode:

When this method is called synchronously, a return object containing the output parameters is returned to the caller immediately.

var returnObject = ssCore.Win.setFocus( paramsObject );


Notes:

None.


Examples:

ssCore.Win.setFocus({hwnd:ssGlobals.ssHWND});