FilePopup Method
The FilePopup method displays a file selection dialog in the center of the current frame. The dialog lets the user select a file by navigating among various file directories. The dialog contains an Open or Save button and a Cancel button. You may also specify file filters that aid the user in selecting a file.
This method has the following syntax:
integer = CurFrame.FilePopup( [ messagetext = nvarchar(256) ],
reply = StringObject, [operation = integer])
or
integer = CurProcedure.FilePopup( [ messagetext = nvarchar(256) ],
reply = StringObject, [operation = integer])
The FilePopup method may be invoked from a 4GL procedure (CurProcedure) only when the 4GL procedure has been invoked from a user frame.
This method has the following parameters:
messagetext
Contains text that is displayed in the dialog
reply
Specifies a default file and one or more file filters. When the user selects a file, the full name of the selected file is returned in the reply parameter.
operation
Determines whether the selection box has a Save button or an Open button. Possible values are FOP_OPEN or FOP_SAVE. If you do not specify the operation parameter, the file selection box will have an Open button.
The method returns PU_OK if the user clicks OK and PU_CANCEL if the user clicks Cancel. Descriptions of system constant values and their numeric equivalents are listed in
Pop-up Reply Codes (see
Pop-up Reply Codes).
There are two methods of using the reply parameter: simple and advanced.