PrtAddByName
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:
-
Das angegebene Objekt wird mit der in der Datenbank gespeicherten Unicode-Unterstützung geladen. Es findet keine Konvertierung des Objekts statt.
-
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.
-
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);
...