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

 Name:         »Font selector do« - Display font selector in a modal 
               dialog.

 Opcode:       187

 Syntax:       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 );

 Description:  The call fnts_do displays the font selector in a modal 
               dialog. The following apply:

                Parameter     Meaning

                fnt_dialog    Pointer to management structure
                button_flags  Flags for supported buttons:
                               0x0001 = Select checkbox for names
                               0x0002 = Select checkbox for style
                               0x0004 = Select checkbox for height
                               0x0008 = Select checkbox for 
                                       width/height ratio
                               0x0100 = Display checkbox for names
                               0x0200 = Display checkbox for style
                               0x0400 = Display checkbox for height
                               0x0800 = Display checkbox for 
                                       width/height ratio
                               0x1000 = Width/height ratio adjustable
                               0x2000 = Button "Set" selectable
                               0x4000 = Button "Mark" selectable
                id_in         Font ID of the displayed font
                pt_in         Height in 1/65536 point
                ratio_in      Width/height ratio in 1/65536
                check_boxes   Status of the checkboxes
                id            Font ID of the selected font
                pt            Height in 1/65536 point
                ratio         Width/height ratio in 1/65536

               Hint: This function is the counterpart to 
               fnts_open/fnts_evnt/fnts_close. This function opens a 
               modal dialog and only returns to the caller when one of 
               the exit buttons was activated.

 Return value: This function returns the index of the exit button

                1  =  Cancel 
                2  =  OK 
                3  =  Set 
                4  =  Mark 
                5  =  Options 

 Availability: The presence of this call should be checked for using 
               appl_getinfo (Opcode 7).

 Group:        Font selection

 See Also:     Binding   fnts_open   fnts_evnt   xFSL interface