UIMatcher Class Reference

Public Member Functions#
	UIMatcher (const _< IMatcher > &matcher)
ASet< _< AView > >	toSet () const
AVector< _< AView > >	toVector () const
_< AView >	one () const
UIMatcher &	includeInvisibleViews ()
template<class Action>
UIMatcher &	perform (Action &&action)
UIMatcher	findNearestTo (UIMatcher matcher)
	Finds the nearest view to the specified one.
template<class Assertion>
UIMatcher &	check (Assertion &&assertion, const char *msg="no msg")
UIMatcher	parent () const
UIMatcher	allChildren () const
UIMatcher	operator| (const UIMatcher &matcher) const
UIMatcher	operator& (const UIMatcher &matcher) const

Static Public Member Functions#
static UIMatcher *	current ()

Member Function Documentation#

findNearestTo()#

UIMatcher UIMatcher::findNearestTo ( UIMatcher matcher )

inline

Finds the nearest view to the bottom right corner of the specified view. The bottom right corner is chosen in order to simulate human eye scanning (which is from top-left to bottom-right).

Useful when finding fields by their labels:

_new<ALabel>("Login"),
_new<ATextField>(),
_new<ALabel>("Password"),
_new<ATextField>(),
...
By::type<ATextField>().findNearestTo(By::text("Login")) // <- matches the first ATextField
By::type<ATextField>().findNearestTo(By::text("Password")) // <- matches the second ATextField

Parameters

matcher

UIMatcher of a view to find the nearest to. The UIMatcher is expected to match only one view.

Returns

the nearest view

© 2025 AUI Framework Contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. All trademarks are property of their respective owners.

Contents

Public Member Functions

Static Public Member Functions

View Page SourceEdit Page Source