Show / Hide Table of Contents

Method uiimageFinder.Exists(+ 1 overload)


Overload

Finds the first image displayed in the specified window or other area. See uiimage.find.

public bool Exists(IFArea area)
Parameters
area  (IFArea)

Where to search:

  • wnd - window or control (its client area).
  • elm - UI element.
  • System.Drawing.Bitmap - image.
  • RECT - a rectangle area in screen.
  • IFArea - can contain wnd, elm or Bitmap. Also allows to specify a rectangle in it, which makes the area smaller and the function faster. Example: new(w, (left, top, width, height)).
Returns
bool

If found, sets uiimageFinder.Result and returns true, else false.

Exceptions
AuWndException

Invalid window handle.

ArgumentException

An argument of this function or of constructor is invalid.

AuException

Something failed.

Remarks

Functions Find and Exists differ only in their return types.


Overload(top)

Finds the first image displayed in the specified window or other area. Can wait and throw NotFoundException.

public bool Exists(IFArea area, Seconds wait)
Parameters
area  (IFArea)

Where to search:

  • wnd - window or control (its client area).
  • elm - UI element.
  • System.Drawing.Bitmap - image.
  • RECT - a rectangle area in screen.
  • IFArea - can contain wnd, elm or Bitmap. Also allows to specify a rectangle in it, which makes the area smaller and the function faster. Example: new(w, (left, top, width, height)).
wait  (Seconds)

The wait timeout, seconds. If 0, does not wait. If negative, does not throw NotFoundException.

Returns
bool

If found, sets uiimageFinder.Result and returns true. Else throws exception or returns false (if wait negative).

Exceptions
AuWndException

Invalid window handle.

ArgumentException

An argument of this function or of constructor is invalid.

AuException

Something failed.

NotFoundException

Remarks

Functions Find and Exists differ only in their return types.