pyWinAuto: pywinauto.findwindows -- Provides functions for iterating and finding windows

findwindows

Provides functions for iterating and finding windows


Functions

f find_window() ...

Call findwindows and ensure that only one window is returned

Calls find_windows with exactly the same arguments as it is called with so please see find_windows for a description of them.

f find_windows(class_name=None, class_name_re=None, parent=None, process=None, title=None, title_re=None, top_level_only=True, visible_only=True, enabled_only=True, best_match=None, handle=None, ctrl_index=None, predicate_func=None, active_only=False) ...

Find windows based on criteria passed in

Possible values are:

  • class_name Windows with this window class
  • class_name_re Windows whose class match this regular expression
  • parent Windows that are children of this
  • process Windows running in this process
  • title Windows with this Text
  • title_re Windows whose Text match this regular expression
  • top_level_only Top level windows only (default=True)
  • visible_only Visible windows only (default=True)
  • enabled_only Enabled windows only (default=True)
  • best_match Windows with a title similar to this
  • handle The handle of the window to return
  • ctrl_index The index of the child window to return
  • active_only Active windows only (default=False)

f enum_windows() ...

Return a list of handles of all the top level windows

f enum_child_windows(handle) ...

Return a list of handles of the child windows of this handle

Classes

C WindowNotFoundError(...) ...

No window could be found

This class contains 2 members.

C WindowAmbiguousError(...) ...

There was more then one window that matched

This class contains 2 members.

See the source for more information.