daVinci API Definition - Window Commands

window(title(string))

window(show_message(string))

window(show_status(string))

window(position(integer,integer))

window(size(integer,integer))

window(file_browser(boolean,string,string,string,string,btypes,boolean))

By using this command, the application has the opportunity to use daVinci's file browser for its own purpose. This file browser does not start any operation in daVinci after the user has selected a file. Instead, the selected file (and type) is returned to the application by sending answer browser_answer(...). Due to the manifold features of the daVinci file browser, the application need to specify several parameters which have the following semantic:

1. boolean (first one)
   Flag for opening a file. Should be true if the browser is used to open a file, false otherwise. There are two differences between an opening and saving browser: The opening browser does not ask the user with a confirm window if the selected file exist (which is done by the saving browser to avoid accidental overwriting) and the opening browser does not allow to choose a not existing file (whereas the saving browser does).

2. string (first one)
   Window title of the file browser.

3. string (second one)
   Short label text of the left activation button that is responsible for closing the browser. Should be usually "Open", "Save" or something like that.

4. string (third one)
   Initial directory of the browser. If empty (i.e. ""), the home directory of the user is used as default.

5. string (forth one)
   Initial file of the browser in the initial directory, may be empty (i.e. ""). The entry of the selection field of the browser at start-up will be composed of the initial directory and the initial file.

6. btypes
   This list specifies the types (i.e. file patterns), available in the Types menu of the browser. The list need to have at least one entry to retrieve the default type of the browser which is always the first type of the list. An empty list is not allowed and will force an error. The elements of list btypes are three-tuples with the following syntax:
   bt(string,string,string)

   1. string: A plain text description of the type, e.g. "PostScript Files"
   2. string: The pattern for the type in shell notation, e.g. "*.ps"
   3. string: An optional postfix for the window header, e.g. "PostScript"

   The header postfix (3. string) will be added to the window title of the browser each time the particular type is selected by the user. So, if the window has title "Save" and there are two types with postfix "X" and "Y", then the title of the browser will be either "Save X" or "Save Y". For example, here is a valid btypes parameter for a browser with a C pattern and a generic pattern for all files:

   [bt("C Files","*.c","C"),bt("All Files,"*","")]

7. boolean (second one)
   Flag to show hidden files initially. Should be usually false to filter the hidden files. The user will be able to modify this setting at any time by using the Show hidden check button of the browser.