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.5.7  pdlg_do                                                     TOS

 Name:         »Print dialog - Do« - Open a print dialog.

 Opcode:       207

 Syntax:       int16_t pdlg_do ( PRN_DIALOG *prn_dialog, PRN_SETTINGS 
               *settings, int8_t *document_name, int16_t option_flags 
               );

 Description:  The call pdlg_do opens a modal print dialog. The 
               following apply:

                Parameter      Meaning

                prn_dialog     Pointer to management structure
                settings       Printer settings
                document_name  Document name
                option_flags   Diverse flags:
                                0x0000 =  Display settings dialog
                                0x0001 =  Display print dialog
                                0x0010 =  Always offer No. of copies
                                0x0020 =  Always offer landscape 
                                          format
                                0x0040 =  Always offer scaling
                                0x0100 =  Offer option for even and 
                                          odd pages

               The function only returns to the caller when one of the 
               exit buttons has been activated ('Cancel', 'OK').

 Return value: The function returns the value of the selected button 
               (1 = Cancel, 2 = OK), or the value 0 in case of error.

 Availability: The presence of this function can be checked with 
               appl_getinfo (opcode 7).

 Group:        Print dialogs

 See Also:     Binding   WDIALOG