PrtAddByName

obj -> PrtAddByName(alpha1[, int2[, int3, int4[, int5[, int6]]]]) : int

PrintForm zu einem Printjob hinzufügen

Details

• obj: Seite des PrintJob-Objektes
• alpha1: PrintForm-/PrintFormList-Name
• int2:
  • Optionen (optional):
  • _PrtAddPageBreak
  • _PrtAddTop
  • _PrtAddRelative
• int3: Abstand vom Seitenanfang (optional)
• int4: Abstand vom linken Seitenrand (optional)
• int5:
  • Unicode-Unterstützung (optional):
  • _PrtConvNone
  • _PrtConvUnicode
  • _PrtConvAnsi
• int6:
  • Objekttyp (optional):
  • _PrtTypePrintForm
  • _PrtTypePrintFormList
• Resultat: int Seitenumbruch-Flag
• Siehe: Verwandte Befehle , PrtAdd ()

Die Funktionsweise des Befehls ist identisch zu PrtAdd (), jedoch wird anstelle des PrintForm -Deskriptors der Name einer PrintForm in (alpha1) angegeben.

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.

Optional kann mit dem Parameter (int5) das Objekt mit oder ohne Unicode-Unterstützung geladen werden. Folgende Konstanten können übergeben werden:

• _PrtConvNone Das angegebene Objekt wird mit der in der Datenbank gespeicherten Unicode-Unterstützung geladen. Es findet keine Konvertierung des Objekts statt.
• _PrtConvUnicode Das angegebene Objekt wird mit Unicode-Unterstützung geladen. Ist das Objekt ohne Unicode-Unterstützung in der Datenbank gespeichert, findet eine Konvertierung des Objekts statt.
• _PrtConvAnsi Das angegebene Objekt wird ohne Unicode-Unterstützung geladen. Ist das Objekt mit Unicode-Unterstützung in der Datenbank gespeichert, findet eine Konvertierung des Objekts statt.

Wird keine der Konstanten angegeben, werden die Objekte ohne eine Konvertierung geladen (_PrtConvNone).

Das Objekt muss mit der gleichen Unicode-Einstellung geladen werden, wie der Druckjob zu dem das Objekt hinzugefügt werden soll, angelegt wurde. Wird einem Druckjob mit Unicode-Unterstützung ein Objekt ohne Unicode-Unterstützung hinzugefügt (oder umgekehrt), kommt es zu dem Laufzeitfehler _ErrHdlInvalid.

Im Argument (int6) muss der zum Objekt (alpha1) passende Objekttyp angegeben werden. Ist das Argument nicht angegeben, wird _PrtTypePrintForm verwendet.

Beispiel:

tJob # PrtJobOpen(_PrtDocDinA4, '', _PrtJobOpenWrite | _PrtJobOpenTemp, _PrtTypePrintDoc, '', _PrtConvUnicode);
tPage # tJob->PrtJobWrite(_PrtJobPageStart);
tPage->PrtAddByName('pfArticle', _PrtAddRelative, 0, 0, _PrtConvUnicode);
...