This is an old version from the tos.hyp. The new is on GitHub!

8.10 Fileselektoren

Die folgenden Funktionen wurden mit MagiC 4 eingeführt, und ermöglichen die Verwaltung der Dateiauswahl (Fileselektor):

Hinweis: Die Existenz dieser Funktionen kann per appl_getinfo (Opcode 7) festgestellt werden.

Der Hauptvorteil bei der Verwendung dieser Routinen ist darin zu sehen, daß die hier angegebenen Funktionen auch mit alternativen Dateisystemen (Stichwort: lange Dateinamen) zurechtkommen.

Querverweis:
Fileselektor als Dialog   Fileselektor im Fenster   Bedienung der Dateiauswahl

8.10.1 fslx_close

8.10.1.1 Bindings für fslx_close

int16_t fslx_close ( void *fsd )
{
   addr_in[0] = fsd;
   crys_if (191);

   return ( int_out[0] );
}

8.10.2 fslx_do

8.10.2.1 Bindings für fslx_do

void *fslx_do ( int8_t *title, int8_t *path, int16_t pathlen,
                int8_t *fname, int16_t fnamelen, int8_t *patterns,
                XFSL_FILTER *filter, int8_t *paths,
                int16_t *sort_mode, int16_t flags, int16_t *button,
                int16_t *nfiles, int8_t **pattern )
{
   addr_in[0] = title;
   addr_in[1] = path;
   addr_in[2] = fname;
   addr_in[3] = patterns;
   addr_in[4] = filter;
   addr_in[5] = paths;

   int_in[0] = pathlen;
   int_in[1] = fnamelen;
   int_in[2] = *sort_mode;
   int_in[3] = flags;

   crys_if (194);

   *button    = int_out[1];
   *nfiles    = int_out[2];
   *sort_mode = int_out[3];
   *pattern   = addr_out[1];

   return ( (void *) addr_out[0] );
}

8.10.3 fslx_evnt

8.10.3.1 Bindings für fslx_evnt

int16_t fslx_evnt ( void *fsd, EVNT *events, int8_t *path,
                    int8_t *fname, int16_t *button, int16_t *nfiles,
                    int16_t *sort_mode, int8_t **pattern )
{
   addr_in[0] = fsd;
   addr_in[1] = events;
   addr_in[2] = path;
   addr_in[3] = fname;

   crys_if (193);

   *button    = int_out[1];
   *nfiles    = int_out[2];
   *sort_mode = int_out[3];
   *pattern   = addr_out[0];

   return ( int_out[0] );
}

8.10.4 fslx_getnxtfile

8.10.4.1 Bindings für fslx_getnxtfile

int16_t fslx_getnxtfile ( void *fsd, int8_t *fname )
{
   addr_in[0] = fsd;
   addr_in[1] = fname;

   crys_if (192);

   return ( int_out[0] );
}

8.10.5 fslx_open

8.10.5.1 Bindings für fslx_open

void *fslx_open ( int8_t *title, int16_t x, int16_t y, int16_t *whdl,
                  int8_t *path, int16_t pathlen, int8_t *fname,
                  int16_t fnamelen, int8_t *patterns,
                  XFSL_FILTER *filter, int8_t *paths,
                  int16_t sort_mode, int16_t flags )
{
   addr_in[0] = title;
   addr_in[1] = path;
   addr_in[2] = fname;
   addr_in[3] = patterns;
   addr_in[4] = filter;
   addr_in[5] = paths;

   int_in[0] = x;
   int_in[1] = y;
   int_in[2] = pathlen;
   int_in[3] = fnamelen;
   int_in[4] = sort_mode;
   int_in[5] = flags;

   crys_if (190);

   *whdl = int_out[0];
   return ( (void *) addr_out[0] );
}

8.10.6 fslx_set_flags

8.10.6.1 Bindings für fslx_set_flags

int16_t fslx_set_flags ( int16_t flags, int16_t *oldval )
{
   int_in[0] = 0;
   int_in[1] = flags;

   crys_if (195);

   *oldval = int_out[1];
   return ( int_out[0] );
}

8.10.7 Die Bedienung des File-Selektors ab MagiC 4

MagiC stellt ab Version 4.0 eine eigene Dateiauswahlbox zur Verfügung, die neben der Unterstützung von langen Dateinamen auch einiges an Bedienungskomfort bietet, welcher sonst nur von alternativen Selektoren bekannt war. Die folgende Tabelle gibt eine Übersicht über die wichtigsten Shortcuts:

Auch bei der Bedienung der Buttons gibt es einiges zu beachten: Ein Doppelklick auf das 'parent'-Feld geht zurück aufs Wurzelverzeichnis. Ein Klick auf eine Zeile selektiert das entsprechende Objekt. Für den Fall, daß mehrere Dateien auswählbar sind (dies ist durch den Systemaufruf beeinflußbar), werden diese durch Shift-Klick ausgewählt. In jedem Fall kann man eine Datei mit Shift-Klick deselektieren.

Zu beachten ist ferner:

• Lange Dateinamen werden nur dann zurückgegeben, wenn der Aufrufer zuvor mit Pdomain(1) angekündigt hat, daß er damit auch etwas anfangen kann.

• Bei Auswahl eines Ordners durch [Return] wird das Eingabefeld gelöscht. Wenn nichts selektiert ist, selektiert "Cursor runter" die erste Zeile, "Cursor hoch" die letzte.

• Bei den alten Aufrufen fsel_(ex)input() wird der eingestellte Sortiermodus beim Booten auf "nach Namen" gesetzt und später in einer globalen Variablen gemerkt, d.h. der letzte eingestellte Sortiermodus wird bis zum nächsten Bootvorgang gespeichert.

• Bei den alten Funktionen fsel_(ex)input() wird ggf. das Muster "*.*" statt "*" zurückgegeben.

Querverweis: Tastaturbelegung

8.10.8 Fileselektor als Dialog

fsel = fslx_do(..., &button, &nfiles, ...);

if (fsel) /* war der Selektor offen? */
{
   if (button)
   {
      while (--nfiles) /* mehrere Files? */
         fslx_getnxtfile(...);   /* alle abholen */
   }

   fslx_close(fsel); /* alles wieder freigeben */
}

8.10.9 Fileselektor im Fenster

fsel = fslx_open(...);
if (fsel)
{
   do {
      evnt.mwhich = evnt_multi(...);
      rv = fslx_evnt(fsel, &evnt, ..., &nfiles, ...);

      /* Bits für eigene Fenster/Menüs auswerten */
   } while (rv);

   while (--nfiles) fslx_getnxtfile(...);
   fslx_close(fsel);
}