| Category | Misc Forms |
| Default Catalog | Visual FoxPro Catalog\Foundation Classes\Dialogs |
| Class | _locateitem |
| Base Class | Form |
| Class Library | _dialogs.vcx |
| Parent Class | _dialog |
| Sample | ...\Samples\Vfp98\Solution\Ffc\dialogs.scx |
Remarks
This class provides a File Locator dialog box. It is designed to locate a file that your application needs but cannot find.
To use, drop the class on a project or, from the Item Shortcut menu, select Create Form or Create Form. When you drop the class on a project, you can choose between adding the class, creating a subclass, or creating a form. When you add the class to a form, Visual FoxPro displays an Open dialog box so you can specify the name of the form, then creates and opens the form in the Form Designer.
In the cDefaultFileName property, specify the file you want to retrieve. If the file is not located, the oLocateItem object opens a GetFile dialog so you can locate the file.
See Guidelines for Using Visual FoxPro Foundation Classes for more information on using foundation classes.
| Properties, Events, Methods | Description |
| cDefaultFileName property | The name of the file to locate. Default: .NULL. |
| cFilename property | The file name retrieved from the Locate button. When no file is found, the GetFile dialog box appears. Default: .NULL. |
| oLocateItem object | An object reference that contains the return value set to the cFileName property. Default: .F. |