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