waitForCursor Method

Waits for the cursor to appear at the specified position for a specified period of time.

Syntax

C#
Visual Basic
C++/CLI

'Declaration
 
Public Sub waitForCursor( _ 
   ByVal inRow As Integer, _ 
   ByVal inColumn As Integer, _ 
   ByVal wtTime As Integer _ 
)

'Usage
 
Dim instance As ScreenUPG 
Dim inRow As Integer 
Dim inColumn As Integer 
Dim wtTime As Integer 
  
instance.waitForCursor(inRow, inColumn, wtTime)

public void waitForCursor( 
   int inRow,
   int inColumn,
   int wtTime 
)

public: 
void waitForCursor( 
   int inRow,
   int inColumn,
   int wtTime 
)

Parameters

inRow: The row in which the cursor must appear to satisfy the wait. When inRow is set to zero, the wait is satisfied when the cursor appears in the column specified regardless of which row the cursor is in.
inColumn: The column in which the cursor must appear to satisfy the wait. When inColumn is set to zero, the wait is satisfied when the cursor appears in the row specified regardless of which column the cursor is in.
wtTime: The number of milliseconds to wait for the condition to be satisfied before timing out.

Exceptions

Exception	Description
TimedOutException	Thrown if waitHostQuiet times out.

Example

C#
Visual Basic

try
{
	int inRow = 17;
	int inColumn = 20;
	int wtTime = 3000;
	
	// Wait for cursor to appear at row 17, column 2, wait for 3 seconds
	screen.waitForCursor(inRow, inColumn, wtTime);
}
catch(TimedOutException toe)
{
	Console.Write("TimedOutException\n");
}

Dim inRow As Integer
Dim inColumn As Integer
Dim wtTime As Integer
            
'Wait for cursor to appear at row 17, column 2, wait for 3 seconds
screen.waitForCursor inRow, inColumn, wtTime

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ScreenUPG Class
ScreenUPG Members
waitForCursor Method
waitHostQuiet Method