WindowFocus Method

Action2 Example

 

Encapsulates the AutoMate™ action in the “Window” group, “Focus.” Finds the window with the title text indicated, focuses the window, and attempts to bring it to the foreground.

 

Declaration

function WindowFocus(varWindowTitle As Variant,

intExactMatch As Integer) As Integer

 

Parameters

varWindowTitle

 The text of the window title to be focused.

 

intExactMatch

 Whether or not the title bar text should match varWindowTitle exactly, or partially. Use “0” for a partial match or “1” for an exact match.

 

Description

The WindowFocus method will attempt to locate a window with the title specified in the varWindowTitle parameter. If a window exists, AutoMate™ will attempt to focus the window and bring it to the foreground. If a window cannot be found, the method returns “1”, indicating a failed step.

 

If multiple windows are found matching varWindowTitle, AutoMate™ will attempt to focus the first one it eternally enumerates.