Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Searches the emulator screen for a string until the string is found, or until the timeout expires.

Namespace:  JollyGiant.Emulation
Assembly:  JGSComdotNet (in JGSComdotNet.dll) Version: 1.0.0.0 (1.0.0.0)

Syntax

C#
StatusCode WaitForString(
	string waitString,
	int timeout
)

...

Visual Basic (Declaration)
Function WaitForString ( _
	waitString As String, _
	timeout As Integer _
) As StatusCode


Visual C++
StatusCode WaitForString(
	String^ waitString, 
	int timeout
)

...

JavaScript
function WaitForString(waitString, timeout);


Parameters

waitString
Type: System..::.StringThe String
The string to search the screen for.

timeout
Type: System..::.Int32Number Int32
Number of seconds to wait for the string to appear before returning.

Return Value

The StatusCode indicating the result of the operation.

...

Status codeDescription
OkThe string was found before the timeout expired.
WHLLNOTCONNECTEDYour application is not currently connected to a session (see Connect(Object)).
WHLLNOFIELDThe specified string was not found on the host presentation space before the timeout expired.
WHLLPARAMETERERRORYou either specified an empty string to search for, or a the timeout value of 0 or less.
WHLLPOSITIONERRORSpecified screen position value is invalid.
WHLLSYSERRORThe method failed due to a system error.

...


The host presentation space can contain nulls in positions where spaces are displayed, in which case a string containing spaces may not be found, even if the string is visible on the screen.

See Also


IQWS3270 Interface
JollyGiant.Emulation Namespace

...