Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.4.1  fsel_boxinput                                               TOS

 Name:         »File selection extended input« - Select filenames.

 Opcode:       91

 Syntax:       int16_t fsel_boxinput ( int16_t *global, int8_t 
               *fs_einpath, int8_t *fs_einsel, int16_t *fs_eexbutton, 
               int8_t *elabel, FSEL_CALLBACK callback );

 Description:  The call fsel_boxinput makes a file-selector dialog box 
               available, which can also be passed a title string. It 
               is used in an extended version of the file-selector 
               BoxKite.

               The function can be passed the following parameters:

                Parameter     Meaning

                fs_einpath    Name of the default access path 
                              (absolute) with appended search mask; 
                              after the call it contains the new 
                              pathname
                fs_einsel     Name of the default file; after the call 
                              it contains the newly selected filename
                fs_eexbutton  Exit button:
                               0  =  'Cancel' was selected 
                               1  =  'OK' was selected 

                fs_elabel     Title-line
                callback      Address of a function that is called by 
                              BoxKite if a GEM message is to be passed 
                              to the main application.
                              This includes not just the message 
                              WM_REDRAW but also WM_MOVED, for 
                              instance, as there are some operating 
                              system versions that offer movement of 
                              windows lying at the back. Messages that 
                              implicitly open new windows or top 
                              existing ones, on the other hand, should 
                              be ignorerd or stored and only processed 
                              after return from the file-selector. 
                              WM_TOPPED messages are not passed 
                              through to the message callback.

               Hint: BoxKite as of Version 2.00 also makes the 
               functions of the MagiC file-selector available. The 
               presence of this call should be checked for using 
               appl_getinfo (opcode 7).

 Return value: It is imperative that the return value of the function 
               (0 = error) is respected, as a shortage of memory, for 
               instance, may make it impossible to use a file- 
               selector.

 Availability: If BoxKite from Version 1.71 on is installed. This can 
               be checked for by the presence of the cookie HBFS. But 
               note that this is also present for versions earlier 
               than Version 1.71.

 Group:        File-selector library

 See Also:     Binding   XFS-concept in MagiC