Global DataUF_UI_create_filebox
Create an File Selection Box dialog.
See Also
extern int UF_UI_create_filebox (
char * prompt_string,
char * title_string,
char * filter_string,
char * default_name,
char * filename,
int * response );
char * | prompt_string | Input | Text for standard prompt. | char * | title_string | Input | The dialog title. | char * | filter_string | Input/Output | The initial value of filter_string is used to initialize
the Filter list and text field. If it contains only the
pattern and not the path, then "/current_dir/pattern"
is used for the filter. If it contains only the path
and not the pattern, then "\path\*" is used for the
filter. If the path doesn't exist,"\current_dir\*" is
used for the filter. On Unix when OK is selected from the
FSB dialog, the filter_string is the complete path+pattern
of the filter.
On NT, the FSB dialog doesn't have a filter edit box.
Therefore, when OK is selected, the returned filter_string
is always set to the folder + '*' + extension of the selected
file.
The user must allocate a buffer big enough to hold the
maximum possible file filter_string, which is
UF_CFI_MAX_PATH_NAME_SIZE bytes. | char * | default_name | Input | The default name is used to initialize the Selection
text field. If it's an empty string or NULL string, the
Selection text field is set to the current directory. | char * | filename | Output | When OK is selected from the FSB dialog, filename
is whatever was typed into the Selection field.
Usually, it is a complete path+name if the string is
automatically set by clicking on one of the files in
the filter list.
Note: An error message displays if no filename is
entered; even if there is a directory path in the
selection field.
It is caller's responsibility to allocate enough
memory for the filename string. | int * | response | Output | UF_UI_OK: OK was selected
UF_UI_CANCEL: CANCEL was selected | Environment
Internal |