RanorexNetRanorexNet Documentation
FindForm Method (title, titleSearchMatchMode, className, activate, timeout)
NamespacesRanorexApplicationFindForm(String, SearchMatchMode, String, Boolean, Int32)
The function retrieves a new form whose title and class name match the specified strings.
Declaration Syntax
C#Visual BasicVisual C++
public static Form FindForm(
	string title,
	SearchMatchMode titleSearchMatchMode,
	string className,
	bool activate,
	int timeout
)
Public Shared Function FindForm ( _
	title As String, _
	titleSearchMatchMode As SearchMatchMode, _
	className As String, _
	activate As Boolean, _
	timeout As Integer _
) As Form
public:
static Form^ FindForm(
	String^ title, 
	SearchMatchMode titleSearchMatchMode, 
	String^ className, 
	bool activate, 
	int timeout
)
Parameters
title (String)
Title of the application.
titleSearchMatchMode (SearchMatchMode)
Defines how to match window titles during search operations. The following values can be used: MatchExact, MatchFromStart, MatchSubstring, MatchRegExp
className (String)
The class name of the form.
activate (Boolean)
Specifies whether the control is to be activated.
timeout (Int32)
Timeout in milliseconds.
Return Value
A new form or null if an error occurs.
Remarks
Supported only in RanorexPro. This function does not search child windows. This function performs a case-sensitive search. To search child windows, use the FormFindChild... functions. If an application cannot find a form, the function returns null.
Exceptions
ExceptionCondition
ArgumentNullExceptionThrown when the title is null.
ControlNotFoundExceptionThrown when a control with the title cannot be found.

Assembly: RanorexNet (Module: RanorexNet) Version: 1.5.1.4524