Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.10.4  fslx_getnxtfile                                            TOS

 Name:         »File SelectionX GetNextFile« - ermittelt alle weiteren 
               selektierten Einträge der Dateiauswahl.

 AES-Nummer:   192

 Deklaration:  int16_t fslx_getnxtfile ( void *fsd, int8_t *fname );

 Beschreibung: Die Funktion ermittelt alle weiteren, selektierten 
               Einträge der Dateiauswahl. Es gilt:

                Parameter  Bedeutung

                fsd        Deskriptor, der beim Öffnen der Auswahl 
                           zurückgeliefert wurde
                fname      Name des ermittelten Eintrags

               Hinweis: Wurde das Flag GETMULTI bei fslx_do oder 
               fslx_open übergeben, wird durch fslx_do bzw. fslx_evnt 
               im Parameter nfiles die Anzahl der Dateien 
               zurückgegeben, die zusätzlich zu dem in fname 
               zurückgegebenen noch selektiert sind. Man kann die 
               weiteren Dateien mit fslx_getnxtfile abrufen. Erst 
               danach darf man fslx_close aufrufen.

 Ergebnis:     Die Funktion liefert den Wert 0, wenn keine weitere 
               Datei ausgewählt ist, bzw. den Wert 1, falls noch ein 
               Dateiname kopiert wurde.

 Verfügbar:    Das Vorhandensein dieser Funktion kann per appl_getinfo 
               (Opcode 7) festgestellt werden.

 Gruppe:       Fileselektoren

 Querverweis:  Binding   fslx_open   fslx_close