UI Actions › Actions › Filter List of Windows

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"