std-getfilem


Synopsis

(std-getfilem <msg> <def> <ext> <flag>)

Description

Opens a dialog box as with getfiled, but you may mark multiple files and a list of existing files is returned instead of just one.

Selecting from different directories:

With using the flag 1 it is possible to select multiple files from more than one directory, without flag 1 you may only select files from one directory, using the same dialog definition as with command FILES in older releases. (acad_dlfmulti from ACAD-DCL)

Without flag 1:

This function is internally used by the AutoCAD command FILES-Unlock and Delete options (defined in ACADAPP) but the method is not exported to AutoLISP.

From the documentation there:

acad_dlfmulti is used by the FILES command's Delete and Unlock options. It is similar to acad_dlfname (above), except that:

- its file listbox has the "multiple_select" attribute,

- its file listbox does not have the "allow_accept" attribute,

- it has additional "Select all" and "Clear all" buttons, and

- its title bar label is slightly different.

Sort order:

The normal sort order is by name. Setting flag 16 sorts by extensions, in the same order as provided in the extension pattern and setting flag 32 sorts the files by modification date, newer files first. This affects the display in the dialog and the return value.

Arguments

msg: a string to be displayed as title in the dialog box.

def: the default value for the filename to be returned. If the filename contains a path, this path is used as default path on the left side of the dialog.

ext: a list of allowed extensions to be selected and returned.

flag: 1 - not using acad_dlfmulti (from one dir only)

instead using private dialog for seperate dirs

without bitvalue 1 you can only multiple select from one dir!

2 - disables text input

4 - allows arbitrary extensions

8 - searches library path, doesn't return paths

16 - sort by extension instead by name

32 - sort by date instead by name or extension (overrides 16)

Return Value

A list of selected filenames string or NIL.

Side Effects

Interrupts the program flow, raises a dialog box and waits for the user to select files from a list and to press "OK" or "Cancel".

Module

(std-require 'GETFILEM)

Defined in GETFILEM