Move Window Action Icon

Move Window Action

Declaration

<AMWINDOWMOVE WINDOWTITLE="text" WINDOWCLASS="text" WINDOWHANDLE="number" ALLOWHIDDEN="yes/no" POSITION="options" XPOS="number" YPOS="number" {also accepts all standard Window Dissection parameters}>

See Also

Close Window, Maximize Window, Focus Window, Minimize Window, Hide Window, Unhide Window, Resize Window, Restore Window, Wait for Window, End Process

Description

Moves the specified window to the specified coordinates.

Practical Usage

To move a Window to a certain location on the screen - often to ensure mouse clicks line up properly.

Parameters

General Tab

Window Title
Text, Required
MARKUP:
a) WINDOWTITLE="Untitled - Notepad"

Specifies the title of the Window to restore. The value is case-insensitive. This parameter supports wildcards (* and ?), for example "*Internet Explorer* would include all Windows containing that text. Note: If this parameter is left blank the action assumes it is searching for a Window title that is blank - to ignore the WIndow title, use *.

Window Class
Text, Required
MARKUP: WINDOWCLASS="Outlook Express Browser Class"

Specifies the class of the Window to act on. The value is case-insensitive. This parameter supports wildcards (* and ?), for example "*Internet Explorer* would include all Windows classes containing that text. Note: If this parameter is left blank the action assumes it is searching for a Window class that is blank - to ignore the WIndow class, use *.

Window Handle
Number, Optional - Default - 0
MARKUP: WINDOWHANDLE="555735"

Specifies the handle of the Window to act on. If set to 0 or omitted the parameter is ignored.

Include Hidden Windows
Yes\No, Optional - Default NO
MARKUP: ALLOWHIDDEN="YES"

When enabled, specifies that hidden (non-visible) windows should be included in the window search. By default hidden windows are considered unavailable.

Position
Options, Optional - Default "custom"
MARKUP: POSITION="upper_left"

Specifies the location on the screen relative to it's corners or "custom". If "custom" (default) is specified the XPOS and YPOS parameters must be specified, otherwise they are ignored.

XPos
Number, Optional - Default 0
MARKUP: XPOS="250"

Specifies the X pixel coordinate location on the screen that the window should be moved to. The Position [POSITION=] parameter must be set to "custom" otherwise this parameter is ignored.

YPos
Number, Optional - Default 0
MARKUP: YPOS="200"

Specifies the Y pixel coordinate location on the screen that the window should be moved to. The Position [POSITION=] parameter must be set to "custom" otherwise this parameter is ignored.

Contents Tab

The contents tab contains standard Windows dissection parameters used to describe controls or text inside a window. These parameters are the same on every action that specifies a window and are documented under Window Dissection Parameters.

 Notes

Standard Error Handling Options
This action also includes the standard "Error Causes" and "On Error" failure handling options/tabs

More on Error Handling Options

Variables and Expressions
All text fields allow the use of expressions by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, a popup expression builder is available in all these fields by pressing F2.
More on variables...
More on expressions...
More on the expression builder...

Example

<AMWINDOWMOVE WINDOWTITLE="AutoMate 5 Task Builder" POSITION="upper_left">