Window Operation

Maximizes, minimizes, restores, closes, or moves and resizes the scope's window or an element's window.

Behaviour

Risk: Medium · Idempotent: No · Safe to retry: No · Recovery: Not replayed after a crash

Package UI Automation activities VeloPhex.UIAutomation.Activities 0.7.1-rc.12 · Supported (Core profile) · type id velophex.ui.windowOperation

Windows · Needs an interactive desktop session

Properties#

Input#

Target#

Target · String · Optional · Default: Not specified in package metadata

An element whose window is changed (a dialog, another window of the application). Empty changes the window of the enclosing Use Application/Browser.

Operation#

Operation · String · Required · Default: Maximize

Maximize, Minimize, Restore, Close (as the window's close button would) or MoveResize.

Allowed values: Maximize, Minimize, Restore, Close, MoveResize.

X#

X · Int32? · Optional · Default: Not specified in package metadata

The window's new left edge, in screen pixels. Empty keeps it.

Shown when Operation=MoveResize.

Y#

Y · Int32? · Optional · Default: Not specified in package metadata

The window's new top edge, in screen pixels. Empty keeps it.

Shown when Operation=MoveResize.

Width#

Width · Int32? · Optional · Default: Not specified in package metadata

The window's new width, in pixels. Empty keeps it.

Shown when Operation=MoveResize.

Height#

Height · Int32? · Optional · Default: Not specified in package metadata

The window's new height, in pixels. Empty keeps it.

Shown when Operation=MoveResize.

Session#

Session · String · Optional · Default: Not specified in package metadata

The session id from a Use Application/Browser scope. Empty uses the enclosing scope's session, or outside a scope the most recent matching session.

Timeout (seconds)#

TimeoutSeconds · Int32 · Optional · Default: Not specified in package metadata

How long to keep looking for the element or window. Empty or not positive means the same as the enclosing Use Application/Browser scope, or outside a scope the project default (30 seconds).

Highlight before action#

HighlightBeforeAction · Boolean · Optional · Default: Not specified in package metadata

Draw the highlight around the element before acting on it.

Rules#

  • Must be inside Use Application/Browser.

Retry and risk#

This activity is not marked safe to retry: if it fails partway, check whether its work already happened before running it again. If a run is interrupted and the outcome of a step is unknown, the step is never retried automatically (what to do). How activities declare this: characteristics, retries and risk.

Every activity also has the engine's common properties: Timeout and Continue On Error.

Generated from VeloPhex.UIAutomation.Activities 0.7.1-rc.12. Category: UI Automation › Application & Browser. Keywords: ui, automation, window, maximize, minimize, restore, close, move, resize, position, size.

Properties

Input

Rules

Retry and risk

Related activities