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.8.4  wdlg_evnt                                                   TOS

 Name:         »Window-dialog event« - Evaluate dialog-events

 Opcode:       166

 Syntax:       int16_t wdlg_evnt ( DIALOG *dialog, EVNT *events );

 Description:  The call wdlg_evnt serves for evaluating or handling 
               events in a window-dialog. The following apply:

                Parameter  Meaning

                dialog     Pointer to the dialog structure
                events     Pointer to the EVNT-structure

               Note: This function must be called in an event-loop. 
               The event-bits that refer to the window-dialog are 
               cleared in the bit-vector mwhich. Following wdlg_evnt 
               the EVNT-structure of the application can be used to 
               evaluate the events intended for it.

               If wdlg_evnt returns a 0, the window-dialog has to be 
               closed (call (wdlg_close).

               Note: The iconify-event is not supported by wdlg_evnt. 
               Those wanting to install the Iconifier icon as a window 
               object during wdlg_open therefore have to evaluate this 
               event and process it themselves. The same applies if 
               one wants to install the Sizer icon as an object.

 Return value: The function returns the value 1 if no error has 
               arisen. With a return value of 0, the dialog must be 
               closed.

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

 Group:        Window-dialogs

 See Also:     Binding   wdlg_open   wdlg_close