Calls the common Windows File dialog box, either in Open or Save As mode.
| Parameter | Description | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| <object> | Owner window | ||||||||||||||
| <value> | @FM-delimited array:
| ||||||||||||||
| returnvalue | Full path of selected file (null if operation was canceled). |
Only the first field (<mode>) is required.
/* This code returns as output the variable File which has the new name selected.
The selection types for this example dialog are bitmaps and all files.
For each file type, supply the description followed by "/" followed by the file filter followed by "/". */
CFOpt = ""
CFOpt<1> = 0 ;* open dialog
CFOpt<2> = "Bitmaps (*.bmp)/*.bmp/All Files (*.*)/*.*/"
CFOpt<3> = 1 ;* default type is the first one (bitmaps)
CFOpt<4> = "oilogon.bmp" ;* default filename
CFOpt<5> = 0x200 ; * OFN_ALLOWMULTISELECT from the Microsoft SDK
CFOpt<6> = drive() : "\BMPS\" ; * initial directry
File = Utility("CHOOSEFILE", @window, CFOpt)
Call msg(@window, "You selected the file " : File) |
For more information about Flags, refer to the Microsoft Windows SDK.
Utility function.