Zum Hauptinhalt springen

WinDocPrint

obj -> WinDocPrint([alpha1[, int2[, int3]]]) : int

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von der DLL-Schnittstelle mit grafischer Erweiterung Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service mit grafischer Erweiterung

Inhalt des CtxDocEdit-Objektes drucken

Details

  • obj: Objekt ( CtxDocEdit -Objekt)
  • alpha1: Seitenauswahl (optional)
  • int2: Deskriptor eines PrintDevice -Objektes (optional)
  • int3: Anzahl der exemplare (optional)
  • Resultat: int Fehlerwert Anweisung setzt den globalen Fehlerwert
  • Siehe: Verwandte Befehle

Mit diesem Befehl wird der Inhalt des CtxDocEdit -Objektes gedruckt. Der Deskriptor des CtxDocEdit -Objektes wird in (obj) übergeben.

Im Parameter (alpha1) kann eine Seitenauswahl definiert werden. Ist dieser Parameter leer, wird der gesamte Inhalt des Objektes gedruckt. Es kann eine der Anweisungen 'range', 'odd' oder 'even' übergeben werden:

  • range() Dieser Eintrag definiert einen Bereich oder eine Aufzählung von Seiten die gedruckt werden soll. In Klammern wird die Aufzählung der Seitennummern, ein Bereich von Seiten oder eine Aufzählung von Seitenbereichen angegeben. Bereichsüberlappungen sind nicht erlaubt und führen zu einem Laufzeitfehler.

  • Wert: Resultat

  • 'range()': Alle Seiten

  • 'range(1-10)': Seiten 1-10

  • 'range(1,3,5-9)': Seiten 1, 3 und 5-9

  • 'range(1-10,4-7)': Laufzeitfehler!

  • odd() Dieser Eintrag definiert einen Bereich ungerader Seiten die gedruckt werden sollen.

  • Wert: Resultat

  • 'odd()': Alle ungeraden Seiten

  • 'odd(1,10)': Alle ungeraden Seiten im Bereich 1-10

  • 'odd(1-10)': Alle ungeraden Seiten im Bereich 1-10

  • even() Dieser Eintrag definiert einen Bereich gerader Seiten die gedruckt werden sollen.

  • Wert: Resultat

  • 'even()': Alle geraden Seiten

  • 'even(1,10)': Alle geraden Seiten im Bereich 1-10

  • 'even(1-10)': Alle geraden Seiten im Bereich 1-10

Im Parameter (int2) kann der Deskriptor eines PrintDevice -Objektes übergeben werden. Wird dieser Parameter nicht angegeben, erfolgt der Druck auf dem Standarddrucker.

info

Die Eigenschaften ZoomFactor , QualityX und QualityY vom PrintDevice haben auf diesen Befehl keine Wirkung.

Die Anzahl der zu druckenden Exemplare kann im Parameter (int3) festgelegt werden. Ist der Parameter nicht angegeben, wird die Eigenschaft Copies vom PrintDevice -Objekt ausgewertet. Ist auch diese nicht definiert, wird der Inhalt ein Mal gedruckt.

Beispiel:

// Seiten 1, 3 und 5 bis 7 des Dokumentes auf dem Drucker in tPrtDevice 2 Mal drucken
$ctxDocEdit->WinDocPrint('range(1,3,5-7)', tPrtDevice, 2);

Folgende Fehlerwerte werden von der Funktion zurückgegeben:

  • _ErrGeneric: Allgemeiner Fehler beim Drucken.
  • _ErrOutOfMemory: Speicher für die Interpretation der Seitenauswahl oder den Drucker konnte nicht angefordert werden.

Mögliche Laufzeitfehler