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.11.12  form_xdo                                                  TOS

 Name:         »Form do Xdialog« - Process an extended dialog with 
               user input.

 Opcode:       50

 Syntax:       int16_t form_xdo ( OBJECT *tree, int16_t startob, 
               int16_t *lastcrsr, XDO_INF *tabs, void *flydial );

 Description:  The call form_xdo takes on the handling of user actions 
               in a dialog form. The following apply:

                Parameter  Meaning

                tree       Pointer to object tree of the dialog box
                startob    Index of the editable object where the text 
                           cursor should be at the opening of the 
                           dialog (the object must have the EDITABLE 
                           flag set); it will be 0 if the object tree 
                           contains no editable object
                lastcrsr   Contains the index of the object where the 
                           cursor was at the closing of the dialog
                tabs       Pointer to keyboard tables, or NULL
                flydial    The corresponding parameter returned by 
                           form_xdial, or NULL if foregoing Flydials

 Return value: This will be the index of the object used to close the 
               dialog.

 Availability: The function is only available under MagiC (as of 
               Version 2.0). The presence of the Flydials and keyboard 
               tables as well as the possibility of establishing the 
               last cursor position can be inquired for with 
               appl_getinfo (opcode 14).

 Group:        Form library

 See Also:     Binding   form_do