WinDocPrint
obj -> WinDocPrint([alpha1[, int2[, int3]]]) : int
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:
intFehlerwert - 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.
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
_ErrHdlInvalid: Bei (obj) handelt es sich nicht um ein CtxDocEdit -Objekt bzw. bei (int2) nicht um ein PrintDevice -Objekt._ErrValueInvalid: Argument (alpha1) enthält ungültige Werte.