Description: | Display the select file dialog. |
Used in controls: | None. |
Used in objects: | Form |
Parameters: | VT_BSTR - FileNameX(8192) VT_BSTR - DialogTitleX(8192) VT_BSTR - MaskListX(8192) VT_I4 - DialogStyle S9(9) COMP-5 |
Description of Parameters: | FileName: The field in which the selected file name should be returned. DialogTitle: The text for the title of the select file dialog. MaskList: A Mask list to be used for the "Files of type" list box in the select file dialog. The mask contains pairs of character strings, each pair being separated by the character "|" (vertical bar). The strings within the pairs are also separated by the "|" character. The first string in each pair gives a description to be displayed in the list box; the second string in each pair gives the corresponding pattern (or filter). For example to let the user select a list of all files or only text files, set up Mask with the following string: "All files|*.*|Text files|*.txt" DialogStyle: The style of the select file dialog. The style is obtained by adding a value from each of the groups (type and folder). |
Type Group | The type of dialog to be displayed: POW-CDLFNAME: Neither the head of the pattern in the mask list nor the blank at the end is removed. POW-CDOPEN: (The default) Open file dialog. POW-CDSAVE: Save file dialog. |
Folder Group | Whether the current folder is changed when the user changes folders. POW-CDCHANGEDIR: (The default) Changes the current folder. POW-CDNOCHANGEDIR: Does not change the current folder. |
Return value: | VT_BOOL - ReturnValueS9(4) COMP-5 POW-TRUE means the Open or Save button was pushed. POW-FALSE means the Cancel button was pushed. |
Example: | See the GetFileName Example |
Backward compatibility | GETFILENAME |
Backward compatibility | 1. X(260) |
