AIT_FocusWindow

Description

Acquires a window handle having specified window and class names, and sets the focus.

Format

integer AIT_FocusWindow  (
 string strWndCaption,     // Window's caption
 string strClassName       // Class name
 [,float fTimeOut]         // Time-out
);

Parameters

strWndCaption (input)

Specify the caption of a window.

strClassName (input)

Specify a window's class name.

fTimeOut (input, optional)

Specify the maximum time this function can use to find the control, in units of seconds. The default is the value set in the AIT_SetDefaultWaitTimeout function.

Return values

The return value is the window handle if the function was executed normally, and 0 if not. If the function has returned 0, you can use AIT_GetLastError to acquire an extended error code. The following gives the error codes that AIT_GetLastError might return:

Extended error numberError code
8ERROR_NOT_ENOUGH_MEMORY
14ERROR_OUTOFMEMORY
112ERROR_DISK_FULL
1400ERROR_INVALID_WINDOW_HANDLE
1460ERROR_TIMEOUT

Note