Printer.PrintAction-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob die Druckausgabe auf einen Drucker, in eine Seitenansicht oder in eine Datei geleitet wird.

Namespace: Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

Public Property PrintAction As PrintAction

Dim instance As Printer
Dim value As PrintAction

value = instance.PrintAction

instance.PrintAction = value

public PrintAction PrintAction { get; set; }

public:
property PrintAction PrintAction {
    PrintAction get ();
    void set (PrintAction value);
}

public function get PrintAction () : PrintAction
public function set PrintAction (value : PrintAction)

Eigenschaftenwert

Typ: System.Drawing.Printing.PrintAction

Gibt eine PrintAction-Enumeration zurück.

Hinweise

Wenn PrintToPrinter ausgewählt ist, wird die Druckausgabe an den Standarddrucker des Computers weitergeleitet. Wenn kein Drucker installiert ist, wird ein Fehler ausgelöst.

Wenn PrintToPreview ausgewählt ist, wird die Druckausgabe in einem PrintPreviewDialog-Standardsteuerelement angezeigt.

Wenn PrintToFile ausgewählt ist, wird die Druckausgabe in einer Encapsulated PostScript-Datei (.eps, .ps oder .ai) in dem von der PrintFileName-Eigenschaft festgelegten Pfad gespeichert. Wenn kein Dateiname festgelegt ist, wird ein Fehler ausgelöst. Die Dateien werden in einem 8-Bit-Graustufen-PostScript-Format gespeichert. 24-Bit-RGB-PostScript wird nicht unterstützt.

Hinweis:
Der Benutzer erhält keine Aufforderung zur Eingabe eines Pfads oder einer Dateinamenerweiterung. Um sicherzustellen, dass die Datei über einen gültigen Pfad und eine gültige Erweiterung verfügt, können Sie ein eigenes Dialogfeld implementieren. Verwenden Sie hierfür eine SaveFileDialog-Komponente, und weisen Sie den zurückgegebenen Wert der PrintFileName-Eigenschaft zu, bevor Sie die Print-Methode aufrufen.

Der Benutzer erhält keine Aufforderung zur Eingabe eines Pfads oder einer Dateinamenerweiterung. Um sicherzustellen, dass die Datei über einen gültigen Pfad und eine gültige Erweiterung verfügt, können Sie ein eigenes Dialogfeld implementieren. Verwenden Sie hierfür eine SaveFileDialog-Komponente, und weisen Sie den zurückgegebenen Wert der PrintFileName-Eigenschaft zu, bevor Sie die Print-Methode aufrufen.

In der folgenden Tabelle werden die PrintAction-Werte aufgelistet, die für die PrintAction-Eigenschaft gültig sind.

Enumerationsname	Beschreibung
PrintToFile	Der Druckvorgang wird in eine Datei geleitet.
PrintToPreview	Der Druckvorgang wird in ein Seitenansichtsdialogfeld geleitet.
PrintToPrinter	Der Druckvorgang wird an einen Drucker geleitet.

Hinweis:
Funktionen und Objekte im Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6-Namespace werden für die Tools zur Aktualisierung von Visual Basic 6.0 auf Visual Basic 2008 bereitgestellt. In den meisten Fällen duplizieren diese Funktionen und Objekte Funktionalitäten, die Sie in anderen Namespaces in .NET Framework finden können. Sie sind nur notwendig, wenn sich das Visual Basic 6.0-Codemodell erheblich von der .NET Framework-Implementierung unterscheidet.

Funktionen und Objekte im Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6-Namespace werden für die Tools zur Aktualisierung von Visual Basic 6.0 auf Visual Basic 2008 bereitgestellt. In den meisten Fällen duplizieren diese Funktionen und Objekte Funktionalitäten, die Sie in anderen Namespaces in .NET Framework finden können. Sie sind nur notwendig, wenn sich das Visual Basic 6.0-Codemodell erheblich von der .NET Framework-Implementierung unterscheidet.

Beispiele

Das folgende Beispiel veranschaulicht das Festlegen der PrintAction-Eigenschaft. Dazu sind drei RadioButton-Steuerelemente erforderlich, mit denen der Benutzer eine Druckmethode auswählen kann.

Dim Printer As New Printer
If RadioButton1.Checked = True Then
    Printer.PrintAction = Printing.PrintAction.PrintToPrinter
ElseIf RadioButton2.Checked = True Then
    Printer.PrintAction = Printing.PrintAction.PrintToPreview
Else
    Printer.PrintFileName = _ My.Computer.FileSystem.SpecialDirectories.CurrentUserApplicationData _ 
    & "Form1.eps"
    Printer.PrintAction = Printing.PrintAction.PrintToFile
End If

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.