Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.5.12  pdlg_open                                                  TOS

 Name:         »Print Dialog - Open Window« - Druckdialog im Fenster 
               öffnen.

 AES-Nummer:   202

 Deklaration:  int16_t pdlg_open ( PRN_DIALOG *prn_dialog, 
               PRN_SETTINGS *settings, int8_t *document_name, int16_t 
               option_flags, int16_t x, int16_t y );

 Beschreibung: Die Funktion öffnet ein Fenster mit dem Druckdialog. Es 
               gilt:

                Parameter      Bedeutung

                prn_dialog     Zeiger auf die Verwaltungsstruktur
                settings       Zeiger auf Druckereinstellungen
                document_name  Name des Dokumentes
                option_flags   Diverse Flags
                                0x0000 =  Einstelldialog zeigen
                                0x0001 =  Druckdialog zeigen
                                0x0010 =  Kopien anbieten
                                0x0020 =  Querformat anbieten
                                0x0040 =  Skalierung anbieten
                                0x0100 =  Option für gerade und 
                                          ungerade Seiten
                x              x-Koordinate des Fensters oder -1
                y              y-Koordinate des Fensters oder -1

               Hinweis: Die Struktur settings enthält die 
               Druckeinstellung die mit jedem Dokument gespeichert 
               werden sollte. Wenn zu einem Dokument noch keine 
               Einstellung existiert, kann sie entweder mit 
               pdlg_new_settings erzeugt werden oder die Applikation 
               kann Malloc und anschließend pdlg_dflt_settings 
               aufrufen, um den Speicher zu initialisieren.

               Im Parameter option_flags wird u.a. mitgeteilt, ob der 
               Dialog als Einstell- oder Druckdialog angezeigt werden 
               soll. Mit weiteren Flags kann außerdem festgelegt 
               werden, daß Skalierung, Kopieroption und Querdruck auch 
               dann angeboten werden, wenn ein Treiber sie nicht 
               unterstützt, so daß die Applikation z.B. die Seite 
               gedreht ausgeben muss.

 Ergebnis:     Die Funktion liefert die Kennung des erzeugten Fensters 
               oder im Fehlerfall den Wert 0 zurück.

 Verfügbar:    Das Vorhandensein dieser Funktion kann per appl_getinfo 
               (Opcode 7) festgestellt werden.

 Gruppe:       Druckdialoge

 Querverweis:  Binding   WDIALOG