int MFileSelection (const char *title, char *filter, char *fname, char *dname, int change_cur_dir)

Displays a modal prompt window for a file name selection

Documentation

Displays a modal prompt window for a file name selection. It allows the program to block its flow, waiting for the user input a file name.
Returns:
The boolean False value (integer 0) is returned if the users selects the Cancel button or closes the dialog without choosing a file name, the True value (integer 1) is returned otherwise.
Parameters:
title - The text displayed in the window's title bar.
filter - Specifies the initial file filter value (may be defaulted to the empty string). On return it contains the last used value.
fname - Specifies the initial file name (may be defaulted to the empty string). On return it contains the selected file name.
dname - Specifies the initial directory name (may be defaulted to the empty string). On return it contains the selected directory name (including drive letter under DOS/Windows).
change_cur_dir - Specifies whether the program's current directory should be changed according to the user's selection or not.

alphabetic index hierarchy of classes


MGUI Copyright 1996-2000 Vincenzo Morello

generated by doc++