Window Dissection™ Parameters

AutoMate's Window Dissection™ technology encompasses a group of technologies that provide AutoMate with intelligence about active windows and controls on a system. It can be used to precisely identify any window.

Windows are frequently identified by their title, but occasionally this is not enough. If, for example, there are many windows open with the same window title, it is necessary to specify additional criteria to identify one window from another. Window Dissection allows the specification of a window based on objects, controls, or text inside a window. Multiple objects may be specified which, when taken together, make a description of a unique window on the system.

Window Dissection can be found in the Window trigger , within the properties of all actions that take a window as a parameter and within a number of interactive actions used for extracting/setting data, manipulating controls and window navigation.

Window-related actions that contain Window Dissection technology are:

Minimize Window
Maximize Window

Restore Window

Focus Window

Close Window

Hide Window

Unhide Window

Resize Window

Move Window

Wait for a Window

Interactivity actions that contain Window Dissection technology are:

Move Mouse to Object

Get Text
Set Text

Check
Press

Select Item

Get Selected List Item

Get Selected Tree Item

Select List Item

Select Tree Item

 

Parameters

Window Dissection parameters are most easily set by dragging the provided AutoMate icon from the properties dialog box to the desired window object. This populates the available parameters with the correct specifications.

Window Must Contain the Object

Yes/No, Optional, Default: NO
MARKUP: CONTAINSOBJECT="YES"

Specifies whether or not objects are to be included in the window identification criteria. All other object specification parameters are valid only if this is set to YES.

Object Name

Text, Optional
MARKUP: OBJECTNAME="Font:"

Specifies the name of the object. Valid only if CHECKOBJECTNAME is set to YES.

Object Value

Text, Optional
MARKUP: OBJECTVALUE="Arial"

Specifies the value of the object. Valid only if CHECKOBJECTVALUE is set to YES.

Object Class

Text, Optional
MARKUP: OBJECTCLASS="MsoCommandBar"

Specifies the class of the object. Valid only if CHECKOBJECTCLASS is set to YES.

Object Type

Text, Optional
MARKUP: OBJECTTYPE="ComboBox"

Specifies the type of the object. Valid only if CHECKOBJECTTYPE is set to YES.

Check Object Name

Yes/No, Optional, Default: NO
MARKUP: CCHECKOBJECTNAME="YES"

Specifies whether or not the object name is to be used to identify the object.

Check Object Value

Yes/No, Optional, Default: NO
MARKUP: CHECKOBJECTVALUE="YES"

Specifies whether or not the object value is to be used to identify the object.

Check Object Class

Yes/No, Optional, Default: NO
MARKUP: CHECKOBJECTCLASS="YES"

Specifies whether or not the object class is to be used to identify the object.

Check Object Type

Yes/No, Optional, Default: NO
MARKUP: CHECKOBJECTTYPE="YES"

Specifies whether or not the object type is to be used to identify the object.

Object X Position

Number, Optional, Default: 0
MARKUP: OBJECTXPOS="30"

Specifies the X pixel coordinate location on the screen for the upper left corner of the object. Valid only if CHECKOBJECTPOSITION is set to YES.

Object Y Position

Number, Optional, Default: 0
MARKUP: OBJECTYPOS="158"

Specifies the Y pixel coordinate location on the screen for the upper left corner of the object. Valid only if CHECKOBJECTPOSITION is set to YES.

Check Object Position

Yes/No, Optional, Default: NO
MARKUP: CHECKOBJECTPOSITION="YES"

Specifies whether or not the object position is to be used to identify the object.

Example

<AMWINDOWMAXIMIZE WINDOWTITLE="Untitled - Notepad" CONTAINSOBJECT=YES OBJECTNAME="" OBJECTVALUE="hello world" OBJECTCLASS="edit" OBJECTTYPE="SelectableText" OBJECTXPOS="" OBJECTYPOS="" CHECKOBJECTVALUE="YES" CHECKOBJECTCLASS="YES" CHECKOBJECTTYPE="YES" />

 

"Window Dissection" is a trademark of Network Automation.

See Also

Introduction to AML

Terminal Services

Windows Foreground Timeout

Interacting with Java Applet Window