CallPick(FileType: Integer; const Mask: WideString; ReturnType, Int_Reserved:

Integer; const Str_Reserved: WideString)

Opens and dialog box window to select files.

Parameters:

FileType define the type of file that will be shown in the dialog box. Possible
values are:
const ANY_FILE = 0; const IN_FILE = 39;
const IMAGE_FILE = 1; {const VGF_FILE = 40;}
const VECTOR_FILE = 2; const VLX_FILE = 41;
const VALUES_FILE = 3; const DSF_FILE = 42;
const SIG_FILE = 4; const EXP_FILE = 44; //*.exp
const SGF_FILE = 5; const IML_FILE = 45; //*.iml
const TS_FILE = 7; const DVC_FILE = 46;
const OLDVEC_FILE = 8; const DVL_FILE = 47;
const REF_FILE = 9; //see also const SCR_FILE = 48;
ref_file_plane (61) const SPF_FILE = 49;
const MAP_FILE = 10; const PCF_FILE = 50;
const BMP_FILE = 11; const VDC_FILE = 51;
const SMP_FILE = 12; const FIL_FILE = 52;
const TIF_FILE = 13; const OLDIMG_FILE = 53;
const SM0_FILE = 14; {const RDC_FILE = 55;}
const SM1_FILE = 15; const AVL_FILE = 56;
const SM2_FILE = 16; const ADC_FILE = 57;
const SMT_FILE = 17; const OLDDOC_FILE = 58;
const HSG_FILE = 18; const OLDVAL_FILE = 59; //T - 3/19/99
const COR_FILE = 19; const RGF_FILE = 60;
const BNA_FILE = 20; const REF_FILE_PLANE = 61;
const USERDEF_FILE = 21; //ref_file_plane is the same as ref file
const SYM_FILE = 22; but includes "plane" in the picklist.
const VCT_FILE = 23; const PAL_FILE = 62;
const MDB_FILE = 24; const RNB_FILE = 63;
const IDR_FILE = 25; const IAX_FILE = 64;
const WAV_FILE = 26; const COL_FILE = 65;
const DOC_FILE = 27; const GRASS_FILE_ASCII = 66; //see
const DLG_FILE = 28; also grass_file_binary.
const TRL_FILE = 29; const DXF_FILE = 67;
const SBF_FILE = 30; const DSC_FILE = 68;
const CTG_FILE = 31; const BIL_FILE = 69;
const TIN_FILE = 32; const ISC_FILE = 71; //in waves
const RCL_FILE = 33; directory
const GRASS_FILE_BINARY = 34; const RDC_FILE = 72;
const VECPOINT_FILE = 35; const AVI_FILE = 73;
const VECLINE_FILE = 36; const SHP_FILE = 74; //shape file
const VECPOLY_FILE = 37; const DBF_FILE = 75;
const MIF_FILE = 38; const VAR_FILE = 76;
const PRD_FILE = 77; const GRD_FILE = 83;
const CMD_FILE = 78; const WMF_FILE = 84;
const PREFIX_FILE = 79; //not really a const EMF_FILE = 85;
file type... const IKB_FILE = 86;
const DST_FILE = 80; const DDF_FILE = 87;
const IPF_FILE = 81; const FOUND_VLX_FILE = -942;
const DAT_FILE = 82;

Mask : Is a redundant informations but it is required any way. It is the file mask,
like "*.rst" or "*.vct"

ReturnType : Tell what will be include in the returning string

RET_TYPE_FULL = 1; //returns full filename and path

RET_TYPE_FULLNOEXT = 2; //returns full filename
RET_TYPE_SHORTANDEXT = 3; //returns full filename
RET_TYPE_SHORTNAME = 0; //returns just filename (no ext)
RET_TYPE_EXT = 4; //returns just extension

Int_Reserved: Tell what will be shown in the picklist dialog box. File name with or
without extension, full path, etc.

SHOW_TYPE_SHORTNAME = 0;
SHOW_TYPE_FULL = 1;
SHOW_TYPE_FULLNOEXT = 2;
SHOW_TYPE_SHORTANDEXT = 3;
SHOWTYPE_EXT = 4;

Str_Reserved: This one can have the value 'hide browse' or just an empty string.
For the obvious function of hiding the browse button or not.

Return:

A string value with the user selected file name or a null value if it was canceled

Example of use in Delphi:

FileName := IdrAPI.CallPick(IML_FILE, '*.iml', 0, 0, '');