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.2  fsel_exinput                                                TOS

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

 Opcode:       91

 Syntax:       int16_t fsel_exinput ( int8_t *fs_einpath, int8_t 
               *fs_einsel, int16_t *fs_eexbutton, int8_t *elabel );

 Description:  The call fsel_exinput makes a system file-selector 
               dialog box available in which the user may choose a 
               complete GEMDOS path specification. It may also be 
               passed a title-string that is to appear in the file- 
               selector (normally indicating the action the user is 
               about to take).




               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     Titelzeile

               Notes: The function should be nested with wind_update 
               (BEG_MCTRL or END_MCTRL) to prevent double-clicks being 
               passed on to underlying windows.

               fs_einpath points to a character buffer at least 128 
               bytes long (200 bytes if CD-ROMs are to be accessed). 
               fs_einsel points to a 13-byte buffer (12 for filename 
               characters plus a terminating NULL). fs_elabel points 
               to a buffer up to 30 characters long.

 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: This function is available only from AES 1.4 onwards.

               It is also present in FreeGEM. To check for this 
               feature, use appl_init and check that xbuf.arch is 
               non-zero.

               If it is available, it should be used rather than the 
               fsel_input call, as with the latter the user is not 
               reminded what the function is actually doing.

 Group:        File-selector library

 See Also:     Binding   fsel_input   XFS-concept in MagiC