Waits until a bitmap image appears in the expected location on the screen.
public Rectangle WaitForScreenMatch(Rectangle expectedLocation, string bitmapFile);
public Rectangle WaitForScreenMatch(Rectangle expectedLocation, string bitmapFile, int maxWait, int searchRadius);
expectedLocation: The screen Rectangle to search. These are absolute screen coordinates.
bitmapFile: The bitmap image name or the path to the bitmap. If the path is only a filename, it is assumed to be in the
Data\Files folder of the test.
maxWait: The maximum time milliseconds to wait before raising a Facilita.Exception.TimeoutException.
searchRadius: A screen search radius around the expected location within which to match the bitmap in pixels.
The Rectangle (x,y, width, height) where the image is found.
The bitmap would previously have been created either manually using a capture tool such as fcWinSpy or using the SaveBitmap function.
searchRadius fields are omitted,
maxWait will use the value of MaxWait (default 120,000 milliseconds) and
searchRadius to 0 pixels.
searchRadius it typically used when the
expectedLocation is identical to the original captured image and the
searchRadius value allows for a change in the original location.
bitmapFile can either be an absolute path or a filename. If only a filename is supplied it is assumed to be in the
data\Files for the project. i.e. in code:
string path = Datapath + "Files\\" + bitmapFile;
The .bmp suffix can be omitted from the
All files in the
Files folder for the project (e.g.
C:\<MyWorkspace>\projects\<myProject>\data\Files) will automatically be copied to all injectors. There is no need to associate the with the test in Studio.
wordWindow = FindTopWindow("Document1 - Microsoft Word");
Control toolbar = wordWindow.FindControl("Standard", TextMatch.Exact);
WaitforScreenMatch(toolbar.Rectangle, @"C:\Screenshots\mainWindow.bmp", 60000, 50);
// this will wait for 60 seconds until the saved window is within a 50-pixel radius of where it was in the saved bitmap