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

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

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.

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 may return.

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

• With an empty character string set in strWndCaption, the function finds the window with a blank caption. If multiple windows have a blank caption, the focus is set to the first found window.