Window - Show

Declaration

<AMWINDOW ACTIVITY="unhide" WINDOWTITLE="text" WINDOWCLASS="text" WINDOWHANDLE="number" CONTAINSOBJECT="YES/NO" OBJECTPROPERTYSETS="Toolkit=text,Type=text,Class=text,FrameworkId=text,Name=text,AutomationId=text,Value=text,Role=text,Description=text,X=number,Y=number,Width=number,Height=number,IndexInParent=text,ParentPath=text,Occurrence=number" ALLOWHIDDEN="YES/NO" WINDOWTITLEVARIABLE="text" WINDOWCLASSVARIABLE="text" WINDOWHANDLEVARIABLE="text" RESULTDATASET="text" />

Related Topics  

Overview

Exposes a window that was previously hidden by the Hide window activity. This activity causes the window to become visible on the desktop and at the same time, puts it in front of all other open widows so interactive steps can immediately access it without the use of a Focus step. You can use window title, class, handle and associated objects to specify the window.

Practical usage

Generally used to make visible a window that has been previously hidden by the Hide window activity or opened in a hidden state by the Run activity with the Initial window state parameter set to Hidden.

Parameters

General

This activity comprises Automate Desktop Window Dissection technology to facilitate the discovery of existing windows and their controls. To select the target window:

1. Ensure the window is open and in the foreground (in front of all other open windows).
2. Drag and release the magnifier icon over the window. If the window is supported by this activity, a green border appears around it.
3. Upon releasing the icon, identified window properties are populated onto the editor. These properties can be enabled/disabled or further modified.

Window contents

If multiple windows with the same title exists, it might be necessary to use Automate Desktop Object Editor to specify additional criteria, such as unique objects, controls or properties, in order to distinguish one window from another. To identify additional elements, enable Window must contain the following objects and click Add to open the Object Editor dialog. Do one of the following:

1. Drag and release the magnifier icon over the desired object or control. The Object properties grid is populated with a list of name/value pairs unique to that object. Individual values can be enabled/disabled according to preference.
2. Click Browse to traverse the list of available objects/controls for the selected window. Select the desired object from the Window contents column, and then click OK. The Object properties grid becomes populated with a list of defined properties unique to that object. Individual values can be enabled or disabled according to preference.

Available object properties are described below.

Advanced

Description

Error Causes

On Error

Additional notes

Datasets

A dataset is a multiple column, multiple row container object. This activity creates and populates a dataset containing a specific set of fields in addition to the standard dataset fields. The following table describes these fields (assuming the dataset name assigned is theDataset):

Example

Description

The following sample task performs various window related activities on a Notepad window. Details are illustrated during task execution.

1
2
3
4
5
6
7
8
9
10
11
<AMRUN FILE="Notepad" />
<AMSHOWDIALOG MESSAGE="The next step will minimize the Notepad window." />
<AMWINDOW ACTIVITY="minimize" WINDOWTITLE="*notepad*" />
<AMSHOWDIALOG MESSAGE="The next step will maximize the Notepad window." />
<AMWINDOW ACTIVITY="maximize" WINDOWTITLE="*notepad*" />
<AMSHOWDIALOG MESSAGE="The next step will restore the Notepad window to its original size." />
<AMWINDOW ACTIVITY="restore" WINDOWTITLE="*notepad*" />
<AMSHOWDIALOG MESSAGE="The next step will move the Notepad window to the upper left corner of the screen." />
<AMWINDOW ACTIVITY="move" WINDOWTITLE="*notepad*" />
<AMSHOWDIALOG MESSAGE="The last step will close the Notepad window." />
<AMWINDOW ACTIVITY="close" WINDOWTITLE="*notepad*" />