Breadcrumbs

STImgCtl – Drucken

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.

C#
int SetPrintOptions(int nPageScaling, int nAutoRotateCenter);
C++
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

C#
int SetPrinterCopyCount(short nCopyCount);
C++
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.

C#
int SetPrinterPaperBin(int nPaperBinID);
C++
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.

C#
void PrintWithDialog();
C++
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.

C#
int SetPrinterName(string bstrPrinterName);
C++
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).

C#
int PrintPDFWithAcrobat(int nOptions);
C++
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.

C#
int PrintDirect(short nStartPage, short nEndPage, string bstrPrintername);
C++
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