Show / Hide Table of Contents

Method uiimageFinder.Find(+ 1 overload)


Overload

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

public uiimage Find(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
uiimage

If found, returns uiimageFinder.Result, else null.

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 uiimage Find(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
uiimage

If found, returns uiimageFinder.Result. Else throws exception or returns null (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.