Window Interfacing Library

Aus ExpeccoWiki

Inhaltsverzeichnis 1 Introduction 2 Window Manipulation 3 Window Enumeration 4 Window Queries 5 Window Events

Introduction

The Window Interfacing Library contains function blocks for low level manipulation of a native windows application's on-screen views. This library is still under active construction and does not replace higher level (autoIt, ranorex, selenium, qt etc.) libraries.

Its main purpose is to allow for simple interaction (such as pressing an OK-Button in an interactive application) or to feed a hard-to-automize application with simple data (by simulating button and/or keyboard input). It has been successfully used to interact with an embedded flashplayer application to simulate a user playing and solving board puzzle games, or to click on disturbing OK confirmation dialogs in expecco test sequences.

Due to the fact that this libraries functionality is very limited, we recommend using the autoIt interface library.

Back to Online Documentation.

Window Manipulation

• Window [ Raise & Activate ]
  Bring a window to the foreground and activate it.
• Window [ Lower ]
  Bring a window to the background.
• Window [ Resize ]
  Resize a window.
• Window [ Move ]
  Move a window.
• Window [ Close ]
  Close a window.

Using raise, resize and move, a window can be placed to a well-known location on the screen, to make further automation more reproducable.

Window Enumeration

• Window [ Get Top Window by Title ]
  Find a window, given a matchstring for the title.
• Window [ Get All Top Windows ]
  Generate a collection of all top windows on the screen.
• Window [ Get All Windows ]
  Generate a collection of all windows (includes children) on the screen.
• Window [ Get Window at Screen Coordinate ]
  Find a window, given a coordinate.
• Window [ Get Window from User ]
  Let the operator (user) click on a window in the screen.

• Window [ Get Child Windows ]
  Retrieve a collection of all first-level child windows of some parent window.
• Window [ Get All Child Windows ]
  Recursively rrieve a collection of all child windows of some parent window.

Window Queries

• Window [ Get Title ]
  Get a window's window-title.
• Window [ Get Window Class Name ]
  Get a window's window-class name.
• Window [ Get Window Rectangle ]
  Get a window's bounds.
• Window [ Grab Window Rectangle ]
  Get a bitmap image from a windows contents.

Window Events

• Window [ Simulate Button Event ]
  Simulate a click (press-release) event sequence.
• Window [ Simulate Button Press ]
  Simulate a press event.
• Window [ Simulate Button Release ]
  Simulate a release event.
• Window [ Simulate Key Event ]
  Simulate a key (press-release) event sequence.

Back to Online Documentation.