PrtAdd

obj -> PrtAdd(handle1[, int2[, int3[, int4]]]) : int

PrintForm zu einem Printjob hinzufügen

Details

• obj: Seite des PrintJob-Objektes
• handle1: PrintForm-Objekt
• int2:
  • Optionen:
  • _PrtAddPageBreak
  • _PrtAddTop
  • _PrtAddRelative
• int3: Abstand vom Seitenanfang
• int4: Abstand vom linken Seitenrand
• Resultat: int Seitenumbruch-Flag
• Siehe: Verwandte Befehle , PrtAddByName () , Beispiel , Drucken mit Wasserzeichen (Blog)

Der Befehl fügt die in einem PrintForm -Objekt (handle1) enthaltenen Druckobjekte zu einer Seite (obj) des Druckjobs an der aktuellen Druckposition hinzu. Wird im Argument (int2) die Konstante _PrtAddPageBreak übergeben, wird anhand der aktuellen Druckposition und des umschließenden Rechtecks der hinzuzufügenden Objekte ermittelt, ob automatisch ein Seitenumbruch erfolgt oder nicht.

Der Seitenumbruch erfolgt immer vor dem Hinzufügen der PrintForm . Soll zum Beispiel vor dem Seitenumbruch eine Seitennummer geschrieben werden, reicht es nicht aus den Rückgabewert von PrtAdd auszuwerten. Die Vorgehensweise in diesem Fall ist in einem Beispiel beschrieben.

Soll ein bereits an dieser Stelle gedrucktes Objekt überdruckt werden, kann die Konstante _PrtAddTop angegeben werden.

Die Position des PrintForm -Objekts auf der Seite kann über die Parameter (int3) und (int4) festgelegt werden. Die Angabe der Position erfolgt in logischen Einheiten. Die Einheiten können mit dem Befehl PrtUnitLog () von einer beliebigen Einheit in logische Einheiten umgerechnet werden.

Soll das Objekt relativ zur aktuellen Druckposition positioniert werden, muss in (int2) _PrtAddRelative angegeben werden.

Der Rückgabewert ist 1, wenn ein Seitenumbruch erfolgte und die Konstante _PrtAddPageBreak angegeben wurde, sonst 0.

info

Ist bei untergeordneten Objekten die Eigenschaft FontParent auf true gesetzt, wird der Font vom PrintForm -Objekt nur verwendet, wenn auch bei diesem die Eigenschaft FontParent auf true gesetzt ist. Sonst wird der Font von der Job-Seite (siehe PrtJobWrite () ) verwendet.

Beispiel:

// PrintForm an die Seite anhängen
tPage->PrtAdd(tPrintForm);

// PrintForm an diese oder die nächste Seite anhängen
tPage->PrtAdd(tPrintForm, _PrtAddPageBreak);

// PrintForm an eine fest definierte Position drucken
tPage->PrtAdd(tPrintForm, 0, PrtUnitLog(5.0, _PrtUnitCentimetres), 0); 
tPage->PrtAdd(tPrintForm, 0, PrtUnitLog(5.0, _PrtUnitCentimetres),
                             PrtUnitLog(11.0, _PrtUnitCentimetres));