Methode SetPrintOptions
Mit dieser Methode können die Optionen für einen Druck angepasst werden.
Die gesetzten Parameter werden nur berücksichtigt, wenn ein PDF gedruckt wird.
int SetPrintOptions(int nPageScaling, int nAutoRotateCenter);
long SetPrintOptions(long nPageScaling, long nAutoRotateCenter);
|
Parameter
|
In |
Out |
Mögliche Werte |
Beschreibung |
|---|---|---|---|---|
|
nPageScaling |
✔️ |
|
0 |
Keine Skalierung |
|
1 |
Seite wird auf Papiergröße skaliert (Standard) |
|||
|
2 |
Die größeren Dokumentenseiten abschneiden |
|||
|
nAutoRotateCenter |
✔️ |
|
0 |
Kein automatisches Drehen und Zentrieren |
|
1 |
Die Dokumentenseite wird automatisch gedreht und zentriert, um bestmöglich in das Ausgabe-Medium zu passen (Standard) |
|
Rückgabewert |
Bedeutung |
|
|---|---|---|
|
0 |
Methode erfolgreich ausgeführt |
|
|
< 0 |
Ein Fehler ist aufgetreten |
|
|
|
-1 |
Das geladene Dokument ist kein PDF |
|
|
-2 |
Einer der Parameter enthält einen ungültigen Wert |
Methode SetPrinterCopyCount
Mit dieser Methode kann die Anzahl der Kopien für den Ausdruck eines PDF-Dokumentes gesetzt werden.
Der gesetzte Parameter findet nur bei einem dialogfreien Druck über die Methode PrintDirect Verwendung
int SetPrinterCopyCount(short nCopyCount);
long SetPrinterCopyCount(short nCopyCount);
|
Parameter
|
In |
Out |
Mögliche Werte |
Beschreibung |
|---|---|---|---|---|
|
nCopyCount |
✔️ |
|
1 - 1000 |
Anzahl der anzufertigenden Kopien |
|
Rückgabewert |
Bedeutung |
|
|---|---|---|
|
1 |
Methode erfolgreich ausgeführt |
|
|
<= 0 |
Ein Fehler ist aufgetreten |
|
|
|
-2 |
Falscher oder ungültiger Parameter |
Methode SetPrinterPaperBin
Diese Methode setzt die ID des zu verwendenden Ausgabeschachts des Druckers.
Der Wert für die Paper Bin ID muss vom installierten Druckertreiber abgefragt werden, z.B. mittels WinAPI-Funktion “DeviceCapabilities”. Siehe auch den MSDN-Link zum Thema DEVMODEA structure / wingdi.h.
int SetPrinterPaperBin(int nPaperBinID);
long SetPrinterPaperBin(long nPaperBinID);
|
Parameter
|
In |
Out |
Mögliche Werte |
Beschreibung |
|---|---|---|---|---|
|
nPaperBinID |
✔️ |
|
1 - 70000 |
Ausgabeschacht-ID des Druckers |
|
Rückgabewert |
Bedeutung |
|
|---|---|---|
|
1 |
Methode erfolgreich ausgeführt |
|
|
<= 0 |
Ein Fehler ist aufgetreten |
|
|
|
-2 |
Falscher oder ungültiger Parameter |
Methode PrintWithDialog
Diese Methode löscht den aktuell hinterlegten Druckernamen und alle gesetzten Druckparameter. Beim nächsten Druckvorgang durch PrintPDFWithAcrobat wird wieder die Windows-Druckerauswahl angezeigt.
void PrintWithDialog();
void PrintWithDialog();
Methode SetPrinterName
Mit dieser Methode kann der Name des zu nutzenden Druckers gesetzt werden, um bei einem Druck über eine Adobe-Anwendung (siehe PrintPDFWithAcrobat) die Anzeige der Windows-Druckerauswahl zu umgehen.
int SetPrinterName(string bstrPrinterName);
long SetPrinterName(BSTR bstrPrinterName);
|
Parameter
|
In |
Out |
Mögliche Werte |
Beschreibung |
|---|---|---|---|---|
|
bstrPrinterName |
✔️ |
|
!= NULL |
Name des Druckers |
|
Rückgabewert |
Bedeutung |
|---|---|
|
0 |
Methode erfolgreich ausgeführt |
|
< 0 |
Ein Fehler ist aufgetreten |
Methode PrintPDFWithAcrobat
Aktiviert oder deaktiviert das Ausdrucken über einen Adobe Acrobat Reader oder Adobe Acrobat. Dafür muss der Adobe Acrobat Reader bzw. Adobe Acrobat auf dem System installiert sein. Diese Methode ist nur für Dokumente verfügbar, die mit LoadDocument direkt aus einer Datei auf der Festplatte geladen wurden.
Die Auswahl des Druckers erfolgt einmalig über die Windows-Druckerauswahl. Der gewählte Drucker wird dann bei allen nachfolgenden Aufrufen verwendet, solange die Anwendung geöffnet ist. Optional kann der Name auch über die Methode SetPrinterName gesetzt werden. Soll nach einem Druck wieder die Druckerauswahl angezeigt werden, nutzen Sie bitte die Methode PrintWithDialog. Gestartet werden kann der Druckvorgang selbst über das Drucker-Icon in der Werkzeugleiste des Controls (siehe auch ShowToolbar).
int PrintPDFWithAcrobat(int nOptions);
long PrintPDFWithAcrobat(long nOptions);
|
Parameter
|
In |
Out |
Mögliche Werte |
Beschreibung |
|---|---|---|---|---|
|
nOptions |
✔️ |
|
1 |
Über Acrobat drucken |
|
0 |
Mit dem STImgCtl drucken |
|
Rückgabewert |
Bedeutung |
|
|---|---|---|
|
1 |
Methode erfolgreich ausgeführt |
|
|
<= 0 |
Ein Fehler ist aufgetreten |
|
|
|
0 |
Es konnte keine kompatible Adobe-Anwendung gefunden werden |
Methode PrintDirect
Diese Methode beginnt einen Druckvorgang, bei dem keine weiteren Benutzereingaben benötigt werden.
int PrintDirect(short nStartPage, short nEndPage, string bstrPrintername);
long PrintDirect(short nStartPage, short nEndPage, BSTR bstrPrintername);
|
Parameter
|
In |
Out |
Mögliche Werte |
Beschreibung |
|---|---|---|---|---|
|
nStartPage |
✔️ |
|
>= 1 |
Erste Seite |
|
-1 |
Auswahl aller Seiten |
|||
|
nEndPage |
✔️ |
|
>= 1 |
Letzte Seite |
|
-1 |
Auswahl aller Seiten |
|||
|
bstrPrintername |
✔️ |
|
!= NULL |
Name des Druckers |
|
Rückgabewert |
Bedeutung |
|
|---|---|---|
|
0 |
Methode erfolgreich ausgeführt |
|
|
< 0 |
Ein Fehler ist aufgetreten |
|
|
|
-2 |
Leerer Druckername |
|
|
-3 |
Der Drucker ist nicht vorhanden oder nicht verfügbar |