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.20.5  fnts_do                                                    TOS

 Name:         »Font Selector Do« - Zeichensatzauswahl im modalen 
               Dialog anzeigen.

 AES-Nummer:   187

 Deklaration:  int16_t fnts_do ( FNT_DIALOG *fnt_dialog, int16_t 
               button_flags, int32_t id_in, int32_t pt_in, int32_t 
               ratio_in, int16_t *check_boxes, int32_t *id, fix31 *pt, 
               int32_t *ratio );

 Beschreibung: Die Funktion zeigt die Zeichensatzauswahl in einem 
               modalen Dialog an. Es gilt:

                Parameter     Bedeutung

                fnt_dialog    Zeiger auf Verwaltungsstruktur
                button_flags  Flags für unterstützte Buttons
                               0x0001 = Checkbox für Namen selektieren
                               0x0002 = Checkbox für Stile selektieren
                               0x0004 = Checkbox für die Höhe selekt.
                               0x0008 = Checkbox für 
                                 Breiten/Höhenverhältnis selektieren
                               0x0100 = Checkbox für Namen anzeigen
                               0x0200 = Checkbox für Stile anzeigen
                               0x0400 = Checkbox für Höhe anzeigen
                               0x0800 = Checkbox für 
                                 Breiten/Höhenverhältnis anzeigen
                               0x1000 = Breiten/Höhen Verh. 
                                 einstellbar
                               0x2000 = Button 'setzen' anwählbar
                               0x4000 = Button 'markieren' anwählbar
                id_in         ID des anzuzeigenden Fonts
                pt_in         Höhe des anzuzeigenden Fonts
                ratio_in      dto. jedoch Breiten/Höhen-Verhältnis
                check_boxes   Status der Checkboxen
                id            ID des ausgewählten Fonts
                pt            Höhe des Fonts in 1/65536 Punkten
                ratio         Breiten/Höhen-Verhältnis

               Hinweis: Diese Funktion kann als Gegenstück zu 
               fnts_open, fnts_evnt und fnts_close aufgefaßt werden. 
               Sie kehrt erst dann zum Aufrufer zurück, wenn einer der 
               EXIT-Buttons betätigt wurde.

 Ergebnis:     Die Funktion liefert die Nummer des ausgewählten 
               Buttons (oder 0) zurück, dabei gilt:

                1  =  Abbruch-Button 
                2  =  Ok-Button 
                3  =  Setzen-Button 
                4  =  markieren-Button 
                5  =  optionaler Button 

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

 Gruppe:       Zeichensatzauswahl

 Querverweis:  Binding   fnts_open   fnts_evnt   xFSL-Schnittstelle