system.gui.findWindow

Deprecated by system.vision variations in 8.3

This function was replaced with system.vision.findWindow.

Click here to learn more about system.vision variations.

This function is used in Python Scripting.

Description

Finds and returns a list of windows with the given path. If the window is not open, an empty list will be returned. Useful for finding all instances of an open window that were opened with system.nav.openWindowInstance.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

system.gui.findWindow(path)

Parameters

Type	Parameter	Description
String	path	The path of the window to search for.

Returns

List - A list of window objects. May be empty if window is not open, or have more than one entry if multiple windows are open.

Scope

Vision Client

Code Examples

Example #1 - Finding a Window and Closing It

# This example finds all open instances of the window named "Popup" and closes them all.
  
allInstances = system.gui.findWindow("Popup")
for window in allInstances:
    system.nav.closeWindow(window)