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.17  pdlg_use_settings                                          TOS

 Name:         »Print dialog - Use settings« - Use validated settings.

 Opcode:       205 (sub-opcode 9)

 Syntax:       int16_t pdlg_use_settings ( PRN_DIALOG *prn_dialog, 
               PRN_SETTINGS *settings );

 Description:  The call pdlg_use_settings serves to validate the 
               printer settings that were set with pdlg_new_settings 
               before adopting them for use. The following apply:

                Parameter   Meaning

                prn_dialog  Pointer to management structure
                settings    Printer settings

               This function should be called if a program wants to 
               print immediately and it is not possible to call 
               pdlg_do or pdlg_open and pdlg_evnt (e.g. Calamus print 
               dialogs). The passed printer settings will be validated 
               (and saved for old drivers).

 Return value: The function returns the value 1 if it operates 
               correctly, else 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