create
PW_FILESELECT_MULTIPLE
Make sure that multiple files can be selected in the file select window.
query
PW_FILESELECT_BOX
To allow the user to modify the behaviour and look of the fileselect window, there is always an empty box between the outline and the rest of the winwod. The user may put some objects in this box. The object identifier is returned by this query, so the value filled in is of type "PWObject".
PW_FILESELECT_OUTLINE
To allow the user to modify the behaviour and look of the fileselect window, the user is allowed to change the bahaviour and look of the outline object in the window. Therefore, the user can get the object identifier of the outline with this query tag. The value which is filled in is of type "PWObject".
PW_FILESELECT_MENU
When the user has modified the outline, it is possible to include a 'Do' item which should use the indicated files for its action. Therefore, you can query the PWObject id of the menu which contains all the files.
PW_FILESELECT_DIRECTORY
When the user has modified the outline, it is possible to include a 'Do' item which should use the indicated files for its action. Apart from knowing which files have been indicated, you probably also need to know in which directory to find the files. This can be queries with this tag. A string with maximum length IO_MAXDIRECTORY is copied into the given address.
PW_FILESELECT_FILENAME
When the fileselect object only allows you to indicate one file, then this query tag can be used to get the name of the file which was selected. A string with maximum length IO_MAXFULLNAME is copied into the given address. If the fileselect window allows you to select multiple files, then ERR_IPAR is returned.
change
PW_FILESELECT_TITLE_TEXT
Set the text which has to appear in the title bar of the file select window. The parameter is of type "char *". By default the title is "file select".
PW_FILESELECT_ACTIVATE
Activate the file select window. This tag has no parameters. The file select object is a keypress object. A keypress can be given to it and the window is displayed when that key is pressed. However, the window can also explicitely be asked for by passing this tag to the object.
PW_FILESELECT_ACTION
Set a function which should be called when the file select window is closed. The parameter is of type "Error (*)(PWObject obj, char *directory, void *extra)". The PWObject which is passed back is the fileselect object, the directory is the current directory in the fileselect window, which should be used as searchpath when opening the file. The extra parameter depends on the fileselect object. If only one file can be selected, then this is a "char *", which contains the filename which was selected. If multiple files can be selected, it is of type "PWObject", being the object of type PW_TYPE_MENU which contains the list of files. The PW_MENU_SELECTED_FIRST and PW_MENU_SELECTED_NEXT queries can be used to deteremine which files have been selected.
PW_FILESELECT_FILENAME
Set the default filename which should be suggested. The parameter is of type "char *". If PW_FILESELECT_MULTIPLE was passed during creation of the fileselect object, then nothing will happen.
PW_FILESELECT_DIRECTORY
Set the directory which should be displayed in the fileselect menu. If the directory is "", then it will default to the data directory (cf. DEVDataGet and DEVDataSet). The parameter has type "char *".
PW_FILESELECT_EXTENSION
Set the extensions which should be selected upon in the display of the fileselect window. The parameter has type "char *".
PW_FILESELECT_NOT_STATUS
Set the status for the "not" item in the fileselect window. This tag needs on parameter, any of PW_STATUS_AVAILABLE (default), PW_STATUS_SELECTED or PW_STATUS_UNAVAILABLE.
PW_FILESELECT_SHOWSUB
This tag (which has either TRUE or FALSE as parameter) determines whether subdirectories should be displayed in the fileselect window.

PROGS, Professional & Graphical Software
last edited February 9, 1996