User Tools

Site Tools


ask_display_windows_file_dialog_.htm
Navigation:  ABC Library Reference > SelectFileClass > SelectFileClass Methods >====== Ask (display Windows file dialog) C6H0009.jpg ====== Previous pageReturn to chapter overviewNext page

Ask( [ file queue] [, restore path ] )

blk2blue.jpg

Ask Displays the Windows file dialog.
file queue The label of a QUEUE structure that receives information for the selected files. The structure must be the same as the SelectFileQueue structure declared in ABUTIL.INC. If omitted, the end user may select only one file, for which the Ask method returns the full pathname.
restore path An integer constant, variable, EQUATE, or expression that indicates whether to restore the current path to its pre-file dialog state. A restore path value of one (1) restores the current path; a value of zero (0) does not restore the current path. If omitted, restore path defaults to zero (0).

The Ask method displays the Windows file dialog and returns information, primarily the full pathname, for the selected file or files.

Implementation:

The file queue parameter must name a QUEUE that begins the same as the SelectFileQueue structure declared in ABUTIL.INC:

SelectFileQueue QUEUE,TYPE

Name             STRING(File:MaxFilePath)

ShortName        STRING(File:MaxFilePath)

               END

Return Data Type:     STRING

Example:

FileQ      SelectFileQueue       !declare FileName QUEUE

FileQCount BYTE

CODE

!program code

SelectFile.Ask(FileQ,0)         !multi file dialog, don't restore directory

LOOP FileQCount=1 TO RECORDS(FileQ) !for each selected file

 GET(FileQ,FileQCount)          !get the file information

 MESSAGE(FileQ.Name)            !process the file

END

FileNames = SelectFile.Ask(1)   !single file dialog, restore directory

ask_display_windows_file_dialog_.htm.txt · Last modified: 2021/04/15 15:56 by 127.0.0.1