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-File15.13.3.1  Der xFSL-Cookie                                         TOS

Wenn ein Fontselektor installiert ist, der die xFSL-Schnittstelle un- 
terstützt, dann existiert ein Cookie "xFSL", dessen Wert ein Zeiger 
auf die folgende Struktur ist:

     typedef struct
     {
      unsigned long xfsl;       /* Magic 'xFSL'              */
      unsigned int  revision;   /* Schnittstellen-Revision   */
      unsigned long product;    /* Kennung des Fontselektors */
      unsigned int  version;    /* Version des Fontselektors */
      xFSL_INPUT    xfsl_input; /* einfacher Aufruf          */
      xFSL_INIT     xfsl_init;  /* Init-Aufruf               */
      xFSL_EVENT    xfsl_event; /* Event-Aufruf              */
      xFSL_EXIT     xfsl_exit;  /* Exit-Aufruf               */
      xFSL_INFO     xfsl_info;  /* Info-Aufruf               */
     } xFSL;

Die Komponenten der Struktur im einzelnen:

 (xfsl       Hier steht, nur zur Sicherheit, nochmals die ASCII- 
             Zeichenfolge "xFSL" (entspricht hexadezimal $7846534C).

 revision    Dies ist die Revisionsnummer der xFSL-Schnittstelle, sie 
             enthält z.Z. den Wert 4. Sollte die Schnittstelle 
             erweitert werden, so werden dort entsprechend höhere 
             Werte zu finden sein.

 product     Hier findet sich eine Kennung für den tatsächlich instal- 
             lierten Fontselektor. Diese Angabe ist jedoch nur als zu- 
             sätzliche Information gedacht und sollte von Anwendungs- 
             programmen, die den Fontselektor aufrufen wollen, nicht 
             ausgewertet werden!

             Bisher verwendete Kennungen:

              Kennung  Fontselektor 
              CLVN     Calvino 
              FSEL     FontSel 
              HUGO     HuGo! 

             Die Kennung (wie auch die folgende Versionsnummer) wurde 
             nur für Programme eingeführt, die eine Information über 
             den installierten Fontselektor ausgeben wollen (z.B. das 
             Programm SysInfo).

 version     Die Versionsnummer des installierten Fontselektors als 
             BCD-Zahl (z.B. hexadezimal $100 für Version 1.00). Hier 
             gelten sinngemäß die Anmerkungen zum Feld `product'.

 xfsl_input  Dies ist der Einsprungpunkt für einen vereinfachten Auf- 
             ruf des Fontselektors. Der Fontselektor erscheint dann 
             immer als modaler Dialog und die meisten zusätzlichen 
             Features der xFSL-Schnittstelle können nicht angesprochen 
             werden.

 xfsl_init, xfsl_event, xfsl_exit Diese drei Funktionen bilden zusam- 
             men den erweiterten Fontselektor-Aufruf. Hierüber können 
             alle neuen Features angesprochen werden. Die 
             Vorgehensweise entspricht dem Darstellen eines GEM- 
             Dialogs:

               1. Fontselektor darstellen (xfsl_init)

               2. Eventbehandlung in einer Schleife, bis "OK" oder 
                  "Abbruch" angewählt wurde (xfsl_event)

               3. Fontselektor vom Bildschirm entfernen (xfsl_exit

 xfsl_info   Über diese Aufruf können einige der Features des instal- 
             lierten Fontselektors abgefragt werden, z.B. Drag&Drop- 
             Unterstützung.