PrtFormOpen

PrtFormOpen(int1[, alpha2[, int3]]) : handle

Print-Objekt öffnen

Details

• int1:
  • Objekttyp:
  • _PrtTypePrintForm
  • _PrtTypePrintFormList
  • _PrtTypePrintDoc
• alpha2: Objektname
• int3:
  • Optionen (optional):
  • _PrtConvNone
  • _PrtConvUnicode
  • _PrtConvAnsi
  • _PrtFormOpenLock
• Resultat: handle Deskriptor
• Siehe: Verwandte Befehle , PrtAdd () , PrtAddByName () , PrtFormClose () , Beispiel

Der Befehl öffnet ein PrintForm -, PrintFormList - oder PrintDoc -Objekt, welches in der Datenbank abgelegt ist. In (int1) wird der Typ des zu ladenden Objektes übergeben. Der Objektname (alpha2) ist der Name, unter dem das Formular oder Dokument in der Datenbank abgelegt ist.

Optional kann in (int3) angegeben werden, ob das Objekt mit Unicode-Unterstützung geladen werden soll. 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.
• _PrtFormOpenLock Diese Optioin ist notwendig, wenn das zu öffnende PrintForm-, PrintDocument- oder PrintFormList-Objekt mit PrtFormSave() in der Datenbank gespeichert werden soll.

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

Nachdem das Formular oder Dokument geöffnet wurde, können seine Eigenschaften verändert und mit PrtAdd () einem Druckjob hinzugefügt werden. Stimmt die Unicode-Unterstützung des geladenen Objekts nicht mit der Unicode-Unterstützung des Druckjobs überein, wird der Laufzeitfehler _ErrHdlInvalid erzeugt.

info

Der Suchpfad schließt nicht das neu geladene Druck-Objekt ein. Ein Zugriff auf die Elemente des Formulars bzw. des Dokumentes ist erst nach dem Setzen des Suchpfades mit WinSearchPath () oder mit dem Befehl PrtSearch () möglich. In beiden Fällen kann der von PrtFormOpen zurückgegebene Deskriptor als Startpunkt der Suche verwendet werden. Es kann auch die Anweisung with verwendet werden, um über die Namen der Objekte auf diese Objekte innerhalb des Druck-Objekts zuzugreifen.

Mit dem Befehl PrtFormClose () wird das Objekt wieder geschlossen.

Beispiel:

// Temporären Druckjob öffnen (PrintDocument DinA4, leer)
tJob # PrtJobOpen(_PrtDocDinA4, '', _PrtJobOpenWrite | _PrtJobOpenTemp);

// PrintForm öffnen
tForm # PrtFormOpen(_PrtTypePrintForm, 'Liste.Adresse');

// Erste Seite ankündigen
tPage # tJob->PrtJobWrite(_PrtJobPageStart);

// füge PrintForm hinzu
tPage->PrtAdd(tForm);

// Letzte Seite geschrieben
tJob->PrtJobWrite(_PrtJobPageEnd);

// PrintForm schließen
tForm->PrtFormClose();

// Druckjob schließen und Preview anzeigen
tErr # tJob->PrtJobClose(_PrtJobPreview);