OpenFile Method

Applies to TestComplete 14.0, last modified on January 23, 2019

Description

The method is applied to window objects that correspond to standard Open File dialogs. It simulates the selection of the specified file in the dialog and then closes the dialog.

Declaration

TestObj.OpenFile(FileNameFileType)

TestObj A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section
FileName [in]    Required    String    
FileType [in]    Optional    Variant Default value: -1   
Result None

Applies To

A window object that corresponds to a standard Open File dialog box:

View Mode

This method is available in the Object Browser panel and in other panels and dialogs in both Basic and Advanced view modes.

Parameters

The method has the following parameters:

FileName

The fully-qualified name of the file to be selected.

FileType

A string or an integer value that specifies the type of the file to be opened. This parameter corresponds to the value that is shown in the Files of type box of the standard Open File dialog.

If FileType is specified, the method sets the appropriate value in this box before opening the file. If FileType is omitted or is equal to -1, the method does not change the value of this box.

If FileType is a string, the method treats it as an item’s text that is shown in the drop-down list of the “Files of type” box. If FileType is an integer, the method treats it as the index of the desired item (indexes are zero-based). If the specified item was not found, the method posts an error message to the test log and does not open a file.

Result Value

None.

Remarks

The OpenFile method is not recorded on Windows 7 and Windows Vista; instead, TestComplete records interactions with the Open File dialog elements. However, you can modify the recorded test and manually replace them with the OpenFile method call.

Example

For sample code that demonstrates how to use the method, see Working With Open File and Save File Dialogs.

See Also

SaveFile Method
Working With Open File and Save File Dialogs

Highlight search results