4D v14.3

Print form

Home

 
4D v14.3
Print form

Print form 


 

Print form ( {Tabellenname ;} Formularname {; BereichStart {; BereichEnde}} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
Tabellenname  Tabelle in Zu druckende Tabelle, ohne Angabe Standardtabelle
Formularname  String in Zu druckendes Formular
BereichStart  Lange Ganzzahl in Druckmarke oder Beginn des Bereichs (wenn BereichEnde angegeben)
BereichEnde  Lange Ganzzahl in Ende des Bereichs (wenn BereichStart angegeben)
Funktionsergebnis  Lange Ganzzahl in Höhe des gedruckten Bereichs

Die Funktion Print form druckt das Formular Formularname mit den aktuellen Feldwerten und Variablen der Tabelle Tabellenname. Print form eignet sich zum Drucken komplexer Berichte, die eine komplette Steuerung des Druckvorgangs erforderlich machen.
Tabellenname ist optional. Wird dieser Parameter nicht angegeben, benutzt Print form das Standardformular der Haupttabelle. Print form führt keine Berechnungen in Datensätzen bzw. Umbrüchen durch, erstellt weder Seitenumbrüche noch Kopf- oder Fußteile. Diese Operationen müssen Sie selbst ausführen. Mit Print form werden Datenfelder und Variablen nur in einer festen Rahmengröße gedruckt.

Da Print form nach Drucken des Formulars keinen Seitenumbruch auslöst, können Sie so verschiedene Formulare auf einer Seite kombinieren. Print form ist für komplexe Druckvorgänge mit verschiedenen Tabellen und Formularen gut geeignet. Mit dem Befehl PAGE BREAK legen Sie einen zwischen den Formularen einen Seitenumbruch an. Um ein Formular, dessen Höhe den verfügbaren Platz übersteigt, über die nächste Seite zu drucken, rufen Sie vor PAGE BREAK den Befehl CANCEL auf.

Es gibt drei verschiedene Syntaxarten:

• Detailbereich drucken

 height:=Print form(MeineTabelle;MeinFormular)

In diesem Fall druckt die Funktion nur den Detailbereich, das ist im Formular der Bereich zwischen Kopfzeile und der Marke D.

• Formularbereich drucken

 height:=Print form(MeineTabelle;MeinFormular;Marke)

In diesem Fall druckt die Funktion den durch Marke angegebenen Bereich. Als Parameter übergeben Sie eine Konstante unter dem Thema Formularbereich:

Konstante Typ Wert
Form break0 Lange Ganzzahl 300
Form break1 Lange Ganzzahl 301
Form break2 Lange Ganzzahl 302
Form break3 Lange Ganzzahl 303
Form break4 Lange Ganzzahl 304
Form break5 Lange Ganzzahl 305
Form break6 Lange Ganzzahl 306
Form break7 Lange Ganzzahl 307
Form break8 Lange Ganzzahl 308
Form break9 Lange Ganzzahl 309
Form detail Lange Ganzzahl 0
Form footer Lange Ganzzahl 100
Form header Lange Ganzzahl 200
Form header1 Lange Ganzzahl 201
Form header10 Lange Ganzzahl 210
Form header2 Lange Ganzzahl 202
Form header3 Lange Ganzzahl 203
Form header4 Lange Ganzzahl 204
Form header5 Lange Ganzzahl 205
Form header6 Lange Ganzzahl 206
Form header7 Lange Ganzzahl 207
Form header8 Lange Ganzzahl 208
Form header9 Lange Ganzzahl 209

• Bereich drucken

 height:=Print form(MeineTabelle;MeinFormular;BereichStart;BereichEnd)

In diesem Fall druckt die Funktion den Bereich zwischen den Parametern BereichStart und BereichEnde. Die Werte müssen in Pixel angegeben werden.

Der von Print form zurückgegebene Wert gibt die Höhe des druckbaren Bereichs an. Diesen Wert berücksichtigt die Funktion Get printed height automatisch.

Mit Print form erscheinen keine Druckdialoge. Der Bericht verwendet nicht die Druckereinstellungen, die dem Formular in der Designumgebung zugewiesen wurden. Sie können die Druckereinstellungen vor Aufrufen von Print form auf zwei Arten festlegen:

  • Sie rufen PRINT SETTINGS auf. In diesem Fall bestimmt der Benutzer die Einstellungen.
  • Sie rufen PAGE SETUP auf. In diesem Fall werden die Einstellungen per Programmierung festgelegt.

4D erstellt die zu druckende Seite im Hauptspeicher. Die Seite wird ausgedruckt, wenn die Seite im Speicher voll ist oder wenn Sie den Befehl PAGE BREAK aufrufen. Sie müssen den Druckvorgang mit PAGE BREAK abschließen, damit auch die letzte Seite ausgedruckt wird, selbst wenn sie nicht voll ist (außer im Kontext des Befehls OPEN PRINTING JOB, siehe nachfolgende Warnung).

Warnung: Wird die Funktion in einem Druckauftrag aufgerufen, der mit OPEN PRINTING JOB geöffnet wurde, dürfen Sie für die letzte Seite NICHT PAGE BREAK aufrufen, da OPEN PRINTING JOB sie automatisch druckt. Rufen Sie in diesem Fall den Befehl PAGE BREAK auf, wird eine leere Seite gedruckt. 

Dieser Befehl druckt externe Bereiche und Objekte, z.B. 4D Write oder 4D View Bereiche. Der Bereich wird für jede Ausführung des Befehls neu aufgebaut.

Warnung: Mit Print form werden keine Unterformulare ausgedruckt. Wollen Sie nur ein Formular für solch ein Objekt ausdrucken, verwenden Sie dafür den Befehl PRINT RECORD.

Print form erstellt nur ein Ereignis On Printing Detail für die Formularmethode.

4D Server: Diese Funktion lässt sich auf 4D Server im Rahmen einer Serverprozedur ausführen. In diesem Kontext müssen Sie folgendes beachten:

  • Stellen Sie sicher, dass auf dem Server Rechner kein Dialogfenster erscheint, außer für spezifische Anforderungen.
  • Bei einem Druckerproblem, z.B. kein Papier oder Drucker nicht verfügbar, erscheint keine Fehlermeldung.

Folgendes Beispiel arbeitet wie der Befehl PRINT SELECTION. Der Bericht verwendet jedoch zwei verschiedene Formulare, je nachdem, ob der Datensatz für Scheck oder Bareinzahlung ist:

 QUERY([Register]` Wähle die Datensätze
 If(OK=1)
    ORDER BY([Register]` Sortiere die Datensätze
    If(OK=1)
       PRINT SETTINGS ` Zeige Druckdialoge
       If(OK=1)
          For($vlRecord;1;Records in selection([Register]))
             If([Register]Type ="Scheck")
                Print form([Register];"Scheckvordruck")
  ` Verwenden Sie ein Formular für Schecks
             Else
                Print form([Register];"Vordruck für Bareinzahlung")
  ` Verwenden Sie ein anderes Formular für Bareinzahlung
             End if
             NEXT RECORD([Register])
          End for
          PAGE BREAK ` Stellen Sie sicher, daß die letzte Seite gedruckt wird
       End if
    End if
 End if

Siehe Beispiel zum Befehl SET PRINT MARKER.

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Drucken
Nummer: 5

Im remote Modus anderes Verhalten

 
GESCHICHTE 

Geändert: 4D 2004.5

 
SIEHE AUCH 

CANCEL
PAGE BREAK
PAGE SETUP
PRINT SETTINGS

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v11 SQL Release 6)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)