PrintForm.PrinterSettings-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft ein PrinterSettings-Objekt ab oder legt dieses fest. Dieses Objekt kann zum Festlegen verschiedener Eigenschaften eines Druckers verwendet werden.

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

Syntax

<BrowsableAttribute(False)> _
Public Property PrinterSettings As PrinterSettings

Dim instance As PrintForm
Dim value As PrinterSettings

value = instance.PrinterSettings

instance.PrinterSettings = value

[BrowsableAttribute(false)]
public PrinterSettings PrinterSettings { get; set; }

[BrowsableAttribute(false)]
public:
property PrinterSettings^ PrinterSettings {
    PrinterSettings^ get ();
    void set (PrinterSettings^ value);
}

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

Eigenschaftenwert

Typ: System.Drawing.Printing.PrinterSettings

Gibt ein PrinterSettings-Objekt zurück.

Hinweise

Die von PrinterSettings zurückgegebenen Einstellungen sind die gleichen Einstellungen, die einem Benutzer im Dialogfeld Drucken verfügbar gemacht werden.

Mithilfe der PrinterSettings-Eigenschaft können Sie verschiedene Druckereinstellungen festlegen. Verwenden Sie beispielsweise die Copies-Eigenschaft, um die Anzahl der zu druckenden Kopien festzulegen. Legen Sie mithilfe der PrinterName-Eigenschaft den zu verwendenden Drucker und mithilfe der PrintRange-Eigenschaft den Bereich der zu druckenden Seiten fest.

Hinweis:
Um dem Benutzer die Auswahl der Einstellungen zu ermöglichen, können Sie eine PrintDialog-Komponente verwenden, um das Standarddialogfeld Drucken anzuzeigen und anschließend den PrinterSettings-Eigenschaftenwert der PrinterSettings-Eigenschaft zuzuweisen.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der PrinterSettings-Eigenschaft veranschaulicht, um die Anzahl der zu druckenden Kopien festzulegen und zu überprüfen, ob der festgelegte Drucker gültig ist. Für dieses Beispiel ist es erforderlich, dass auf einem Formular eine PrintForm-Komponente mit der Bezeichnung PrintForm1 vorhanden ist.

PrintForm1.PrinterSettings.Copies = 2
If PrintForm1.PrinterSettings.IsValid Then
    PrintForm1.Print()
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.