CFileDlg Class Description


The CFileDlg class provides an interface for using the standard Open and Save file dialogs. Various properties can be configured, including user-defined title, "file type" filter, and other properties. The Open dialog can select multiple files and the class provides methods for iterating through the list of returned file names. The Open and Save dialogs do not open and save files; rather, they allow you to select file names that may be used for opening and saving files. Iteration using the Start and Next methods is similar to that of the CFileList class.

Usage

Construction

Object = new_filedlg()

Object = CFileDlg:new()

Destruction

Object:delete()

Properties

This class includes numerous properties you can use to control the Open and Save dialogs.

Global Functions using CFileDlg

This higher-level function uses the CFileDlg class internally to fetch a file name but does not require an existing of a CFileDlg object.

GetFileName

Uses the Windows File dialog to fetch a file name for opening or saving.

Creation - Non-class Functions

This function is normally used to create a new CFileDlg object as an alternative to the class-based new method.

new_filedlg

Creates a new instance of a CFileDlg object.

Construction and Destruction - Class Methods

new

Creates a new instance of a CFileDlg object.

delete

Deletes the instance of the CFileDlg object.

Operations

Open

Creates an Open dialog for selecting file names.

Save

Creates a Save dialog for selecting file names.

Start

Initializes the list of file names that were selected. After initialization, use Next to select each name in turn.

Next

Returns the next file name from the collection of names selected using the file dialog. This meethod returns nil when the end of the list is reached.

Related Topics

Script Classes, CFindFiles class, CFileList class, GetFileName, GetFolder


Mira Pro x64 Script User's Guide, Copyright Ⓒ 2023 Mirametrics, Inc. All Rights Reserved.