Maptitude GISDK Help

ChooseFiles()

Summary

Gets the names of one or more existing files using the Windows File Open dialog box.

 

Syntax

fnms = ChooseFiles(array file_types, string title, array options)

 

Argument

Contents

file_types

An array of two-element arrays, with each subarray having a file type description (such as "Workspace") and a specification (such as "*.wrkz")

title

A title for the dialog box

 

Option

Type

Contents

Read Only

Boolean

If "True" the Read Only check box is displayed

Initial Directory

String

The directory first displayed by the dialog box; the directory name must include a trailing backslash

Help

String

A keyword in the help system; it indicates the help topic displayed if the user presses F1

Options Button

String

The name of a macro to run when the Options button is pressed, or null if no Options button is needed

 

Returns

An array of directory and file names, as follows:

 

Element

Type

Contents

1

String

The directory path to the file names in element 2

2

Array

Strings containing the file names (including file extension) selected

 

Notes

Example

geo_files = ChooseFiles( {

     {"Compact (*.cdf)", "*.cdf"},

     {"Standard (*.dbd)","*.dbd"}},

     "Choose one or more Geographic Files", )

 

Error Codes

Error Type

Meaning

Escape

The user clicked Cancel or hit Escape

Error

File_types or one of the options is incorrectly specified

 

See Also

Function

Summary

ChooseDirectory()

Gets the path name to an existing directory/folder

ChooseFile()

Gets the name of a single existing file using the Windows File Open dialog box

ChooseFolder()

Gets the path name to an existing directory/folder

ChooseFileName()

Gets the name of a new file using the Windows File Open dialog box

GetFileInfo()

Gets information about a file.

 

 

©2025 Caliper Corporation www.caliper.com