Common Dialog Box Foundation Class
| Category | System Dialog boxes |
|---|---|
| Default Catalog | Visual FoxPro Catalog\Foundation Classes\Dialogs |
| Class | _comdlg |
| Base Class | Custom |
| Class Library | _system.vcx |
| Parent Class | _custom |
| Sample | ...\Samples\Solution\Ffc\Getfilex.scx |
Remarks
You can use system Open and Save file dialog boxes that mimic the latest Windows ones in your applications. For example, you can have a Places bar on the left side of the dialog box.
To use, drop the class on a project or form or, from the Component Gallery Item Shortcut Menu, select Add to Project or Add to Form. When you add the class to a form, Visual FoxPro places the class icon on the form. You can specify the appropriate property values and provide any necessary input and output objects. When you drop the class on a project, you can choose between adding the class, or creating a subclass.
See Guidelines for Using Visual FoxPro Foundation Classes for more information on using foundation classes.
| Properties, Events, Methods | Description |
|---|---|
| aFileNames array | Array of filenames returned from dialog box.
Default: .F. |
| aFileList array | Array of file extension filters passed to dialog box.
Default: .F. |
| cCustomFilter property | Custom filter the user created while using dialog box.
Default: none |
| cDefaultExtension property | Default file extension to display.
Default: none |
| cFileName property | Name of file selected or initially set as default.
Default: none |
| cFilePath property | Path from which files were selected.
Default: none |
| cFileTitle property | File title property of the selected file(s).
Default: none |
| cInitialDirectory property | Initial directory from which to display files.
Default: none |
| cTitleBar property | Caption for dialog box title bar.
Default: none |
| lAllowMultiSelect property | Specifies whether to allow multiple files.
Default: .F. |
| lFileMustExist property | Specifies whether to allow only existing files to be entered.
Default: .F. |
| lHideReadOnly property | Specifies whether to hides read-only files from list.
Default: .T. |
| lNewExplorer | Specifies whether to use new explorer user interface and features such as Places bar.
Default: .T. |
| lNoChangeDir property | Specifies whether to prevent changing of displayed directory.
Default: .F. |
| lNoNetworkButton property | Specifies whether to prevent including a network button in the dialog box.
Default: .F. |
| lNoPlacesBar property | Specifies whether to prevent a Places bar in the dialog box.
Default: .F. |
| lNoValidate property | Specifies that files are not validated in the dialog box.
Default: .F. |
| lSaveDialog box property | Specifies whether to use Save dialog box instead of Open one.
Default: .F. |
| nFileCount property | Specifies the number of files selected from the dialog box.
Default: 0 |
| nFilterIndex property | Specifies which of the filters were selected from the dialog box.
Default: 0 |
| AddFilter method | Specifies the file extension filters to use when displaying the dialog box.
Syntax: AddFilter(cDescription, cSkeleton) Return: none Arguments: cDescription provides a description of the filter. cSkeleton specifies the file extension filter skeleton. |
| ClearFilters method | Clears all file extension filters.
Syntax: ClearFilters( ) Return: none Arguments: cUser specifies name of user to check |
| ShowDialog box method | Displays dialog box with various options such as filters.
Syntax: ShowDialog box( ) Return: none Arguments: |
| TestDialog box method | Test script for displaying a dialog box.
Syntax: TestDialog box( ) Return: none Arguments: |
See Also
Guidelines for Using Visual FoxPro Foundation Classes | Visual FoxPro Foundation Classes A-Z | Foundation Class Samples