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.3  fsel_input                                                  TOS

 Name:         »File selection input« - Selects filenames.

 Opcode:       90

 Syntax:       int16_t fsel_input ( int8_t *fs_iinpath, int8_t 
               *fs_iinsel, int16_t *fs_iexbutton );

 Description:  The call fsel_input makes a file-selector dialog box 
               available: The following apply:

                Parameter     Meaning

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


               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_iinpath points to a character buffer at least 128 
               bytes long (200 bytes if CD-ROMs are to be accessed). 
               fs_iinsel points to a 13-byte buffer (12 for filename 
               characters plus a terminating NULL).

               Incidentally, AES versions earlier than 1.4 can only 
               display a maximum of 100 files; there a 'ping' warns if 
               not all files can be displayed.

 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: All AES versions, not present in ViewMAX/3, and will 
               crash ViewMAX/2.

 Group:        File-selector library

 See Also:     Binding   fsel_exinput   XFS-concept in MagiC