Translate page

IScreen_Search Method

Owned by Julio Rios (Unlicensed)
Last updated: May 16, 2017
1 min read

Searches the presentation space for a specified string.

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

Syntax

C#
StatusCode Search(
	ref int row,
	ref int column,
	string searchText
)
Visual Basic (Declaration)
Function Search ( _
	ByRef row As Integer, _
	ByRef column As Integer, _
	searchText As String _
) As StatusCode
Visual C++
StatusCode Search(
	int% row, 
	int% column, 
	String^ searchText
)
JavaScript
function Search(row, column, searchText);


Parameters

row
Type: System..Int32
If the string is found, will contain the row where string is found.

column
Type: System..Int32
If the string is found, will contain the column where string is found.

searchText
Type: System..String
The string to search for.

Return Value

The StatusCode indicating the result of the operation.

This can be one of the following values:

Status codeDescription
OkThe method completed successfully. You must check the position value to determine if the string was found.
WHLLNOTCONNECTEDYour application is not currently connected to a session (see Connect(Object)).
WHLLPARAMETERERRORInvalid parameters were specified.
WHLLPOSITIONERRORSpecified screen position value is invalid.
WHLLSYSERRORThe method failed due to a system error.
WHLLNOFIELDThe string was not found.


Remarks


A position on the screen that appears blank may contain a space or a null byte. If the search string contains spaces, and the screen contains null bytes in those positions, the string will not be found, even though it may be visible on the screen.

See Also


IScreen Interface
JollyGiant.Emulation Namespace
ISession..::.Connect(Object)

Send comments on this topic to Jolly Giant Software

Copyright 2009 by Jolly Giant Software, Inc.