PrintForm.PrintAction-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

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

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

Syntax

<BrowsableAttribute(True)> _
Public Property PrintAction As PrintAction

Dim instance As PrintForm
Dim value As PrintAction

value = instance.PrintAction

instance.PrintAction = value

[BrowsableAttribute(true)]
public PrintAction PrintAction { get; set; }

[BrowsableAttribute(true)]
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 Ausgabe an den Standarddrucker des Systems weitergeleitet. Sie können dieses Verhalten überschreiben und den Drucker sowie die Druckereigenschaften mithilfe der PrinterSettings-Eigenschaft explizit festlegen. Wenn kein Standarddrucker verfügbar ist, wird der Benutzer aufgefordert, einen Drucker auszuwählen.

Wenn PrintToPreview ausgewählt ist, wird das Formular in einem standardmäßigen PrintPreviewDialog-Steuerelement von Windows Forms angezeigt.

Wenn PrintToFile ausgewählt ist, wird ein Bild des Formulars in einer Encapsulated PostScript-Datei (.eps, .ps oder .ai) mit dem von der PrintFileName-Eigenschaft festgelegten Pfad gespeichert. Wenn kein Dateiname festgelegt ist, wird der Benutzer zur Eingabe eines Dateinamens aufgefordert.

Hinweis:
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 Rückgabewert 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 Rückgabewert der PrintFileName-Eigenschaft zu, bevor Sie die Print-Methode aufrufen.

Beispiele

Im folgenden Beispiel wird das Festlegen der PrintAction-Eigenschaft veranschaulicht. Für dieses Beispiel ist es erforderlich, dass eine PrintForm-Komponente mit der Bezeichnung PrintForm1 sowie drei RadioButton-Steuerelemente vorhanden sind.

If RadioButton1.Checked = True Then
    PrintForm1.PrintAction = Printing.PrintAction.PrintToPrinter
ElseIf RadioButton2.Checked = True Then
    PrintForm1.PrintAction = Printing.PrintAction.PrintToPreview
Else
    PrintForm1.PrintFileName = _
  My.Computer.FileSystem.SpecialDirectories.CurrentUserApplicationData _
  & "Form1.eps"
    PrintForm1.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.