PrtJobWrite

obj -> PrtJobWrite(handle1) : int

Druckjob schreiben

Details

• obj: Printjob-Objekt
• handle1:
  • Seiten-Deskriptor oder:
  • _PrtJobDoc
  • _PrtJobPageStart
  • _PrtJobPageBreak
  • _PrtJobPageEnd
• Resultat: int Fehlernummer oder Seitendeskriptor
• Siehe: Verwandte Befehle , PrtJobOpen () , Beispiel

Mit dem Befehl wird in einen durch PrtJobOpen () erzeugten Druckjob geschrieben. Das erste Argument enthält den Deskriptor des Druckjobs.

Wird im Argument (handle1) der Deskriptor eines Seiten-Objektes angegeben, wird diese Seite in den Druckjob geschrieben. Der Druckjob kann so seitenweise zusammengestellt werden. Folgende Konstanten können angegeben werden:

• _PrtJobDoc Das gesamte Dokument wird in den Druckjob geschrieben.
• _PrtJobPageStart Es wird eine neue Seite erzeugt.
• _PrtJobPageBreak Die aktuelle Seite wird in den Druckjob geschrieben und eine neue Seite erzeugt.
• _PrtJobPageEnd Die aktuelle Seite wird in den Druckjob geschrieben.

info

Auf eine geschriebene Seite kann nicht mehr zugegriffen werden. Änderungen sind dann nicht mehr möglich.

Der Rückgabewert definiert eine Fehlernummer. Wurde eine der Konstanten _PrtJobPageStart oder _PrtJobPageBreak übergeben, wird der Deskriptor auf die neu erzeugte Seite zurückgegeben.

Beispiel:

// Bereits verbrauchter Platz auf Seite
tAddSize # tPage->ppBoundAdd;

// Maximal zu Verfügung stehender Platz auf Seite
tMaxSize # tPage->ppBoundMax;

// Passt die PrintForm noch auf die Seite?
if (tAddSize:y + tForm->ppFormHeight > tMaxSize:y)
{
  // Nein -> Seitenwechsel
  tPage # tJob->PrtJobWrite(_PrtJobPageBreak);
  ...
}