Filters the passed-in list of Window References (UI Actions).
Filtering is additive, i.e. windows must meet all filter criteria to be included in the results.
Parameters
Windows References
The list of windows to be filtered.
Type: Window reference (list)
Which window
Should the action returns all windows or just the first one from the list?
If filtering is applied, the selection all/first will be made on the list of windows that made it through the filter.
Options:
- all windows
- the first window
Filter by window type
Options:
- no
- standard window
- floating window
Filter by window title
Setting this to anything other than "no" enables filtering window by their title.
Options:
- no
- is …
- contains …
- begins with …
- ends with …
- matches regular expression …
Title filter string
Filter the results by this title string as specified by the 'Filter by window title' parameter. (Only available when filtering by window title is enabled.)
Type: Text
Case-insensitive filtering
Enable if lowercase and uppercase shouldn't make a difference. (Only available when filtering by window title is enabled.)
Type: Boolean (YES
/NO
)
Filter by visibility
Options:
- no
- visible windows only
- minimized windows only
Return Value
Window reference (list)
Related Links
- Search the UI Actions community forum for "Filter List of Windows"