PrinterSettings Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt Informationen darüber an, wie ein Dokument gedruckt wird, einschließlich des Druckers, der es druckt, beim Drucken aus einer Windows Forms-Anwendung.
public ref class PrinterSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
[System.Serializable]
public class PrinterSettings : ICloneable
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Serializable>]
type PrinterSettings = class
interface ICloneable
[<System.Serializable>]
type PrinterSettings = class
interface ICloneable
Public Class PrinterSettings
Implements ICloneable
- Vererbung
-
PrinterSettings
- Attribute
- Implementiert
Beispiele
Im folgenden Codebeispiel wird ein Dokument auf dem angegebenen Drucker gedruckt. Das Beispiel hat drei Voraussetzungen:
Eine Variable mit dem Namen
filePathwurde auf den Pfad der zu druckbaren Datei festgelegt.Eine Methode mit dem Namen
pd_PrintPage, die das PrintPage Ereignis behandelt, wurde definiert.Eine Variable mit dem Namen
printerdes Druckers wurde festgelegt.
Verwenden Sie die System.DrawingNamespaces System.Drawing.Printingund System.IO die Namespaces für dieses Beispiel.
public:
void Printing( String^ printer )
{
try
{
streamToPrint = gcnew StreamReader( filePath );
try
{
printFont = gcnew System::Drawing::Font( "Arial",10 );
PrintDocument^ pd = gcnew PrintDocument;
pd->PrintPage += gcnew PrintPageEventHandler(
this, &Form1::pd_PrintPage );
// Specify the printer to use.
pd->PrinterSettings->PrinterName = printer;
if ( pd->PrinterSettings->IsValid )
{
pd->Print();
}
else
{
MessageBox::Show( "Printer is invalid." );
}
}
finally
{
streamToPrint->Close();
}
}
catch ( Exception^ ex )
{
MessageBox::Show( ex->Message );
}
}
public void Printing(string printer) {
try {
streamToPrint = new StreamReader (filePath);
try {
printFont = new Font("Arial", 10);
PrintDocument pd = new PrintDocument();
pd.PrintPage += new PrintPageEventHandler(pd_PrintPage);
// Specify the printer to use.
pd.PrinterSettings.PrinterName = printer;
if (pd.PrinterSettings.IsValid) {
pd.Print();
}
else {
MessageBox.Show("Printer is invalid.");
}
}
finally {
streamToPrint.Close();
}
}
catch(Exception ex) {
MessageBox.Show(ex.Message);
}
}
Public Sub Printing(printer As String)
Try
streamToPrint = New StreamReader(filePath)
Try
printFont = New Font("Arial", 10)
Dim pd As New PrintDocument()
AddHandler pd.PrintPage, AddressOf pd_PrintPage
' Specify the printer to use.
pd.PrinterSettings.PrinterName = printer
If pd.PrinterSettings.IsValid then
pd.Print()
Else
MessageBox.Show("Printer is invalid.")
End If
Finally
streamToPrint.Close()
End Try
Catch ex As Exception
MessageBox.Show(ex.Message)
End Try
End Sub
Hinweise
In der Regel greifen Sie auf eine PrinterSettings Through PrintDocument.PrinterSettings - oder PageSettings.PrinterSettings Eigenschaften zu, um Druckereinstellungen zu ändern. Die am häufigsten verwendete Druckereinstellung ist PrinterName, die den zu druckden Drucker angibt.
Weitere Informationen zum Drucken mit Windows Forms finden Sie in der System.Drawing.Printing Namespaceübersicht. Wenn Sie aus einer Windows Presentation Foundation-Anwendung drucken möchten, lesen Sie den System.Printing Namespace.
Note
In .NET 6 und höheren Versionen wird das System.Drawing.Common-Paket, das diesen Typ enthält, nur unter Windows-Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps führt zu Kompilierungszeitwarnungen und Laufzeit-Ausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.
Konstruktoren
| Name | Beschreibung |
|---|---|
| PrinterSettings() |
Initialisiert eine neue Instanz der PrinterSettings-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| CanDuplex |
Ruft einen Wert ab, der angibt, ob der Drucker doppelseitiges Drucken unterstützt. |
| Collate |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das gedruckte Dokument sortiert ist. |
| Copies |
Ruft die Anzahl der zu druckende Kopien des Dokuments ab oder legt sie fest. |
| DefaultPageSettings |
Ruft die Standardseiteneinstellungen für diesen Drucker ab. |
| Duplex |
Dient zum Abrufen oder Festlegen der Druckereinstellung für den doppelseitigen Druck. |
| FromPage |
Ruft die Seitenzahl der ersten zu druckende Seite ab oder legt sie fest. |
| InstalledPrinters |
Ruft die Namen aller auf dem Computer installierten Drucker ab. |
| IsDefaultPrinter |
Ruft einen Wert ab, der angibt, ob die PrinterName Eigenschaft den Standarddrucker angibt, außer wenn der Benutzer explizit festgelegt wird PrinterName. |
| IsPlotter |
Ruft einen Wert ab, der angibt, ob der Drucker ein Plotter ist. |
| IsValid |
Ruft einen Wert ab, der angibt, ob die PrinterName Eigenschaft einen gültigen Drucker angibt. |
| LandscapeAngle |
Ruft den Winkel in Grad ab, in dem die Hochformatausrichtung gedreht wird, um die Querformatausrichtung zu erzeugen. |
| MaximumCopies |
Ruft die maximale Anzahl von Kopien ab, mit denen der Drucker den Benutzer gleichzeitig drucken kann. |
| MaximumPage |
Dient zum Abrufen oder Festlegen des Maximums FromPage oder ToPage festlegen, das in einer PrintDialog. |
| MinimumPage |
Ruft das Minimum FromPage ab oder legt dieses fest, oder ToPage das in einer PrintDialog. |
| PaperSizes |
Ruft die Papierformate ab, die von diesem Drucker unterstützt werden. |
| PaperSources |
Ruft die Papierquellfächer ab, die auf dem Drucker verfügbar sind. |
| PrinterName |
Ruft den Namen des zu verwendenden Druckers ab oder legt diesen fest. |
| PrinterResolutions |
Ruft alle Auflösungen ab, die von diesem Drucker unterstützt werden. |
| PrintFileName |
Ruft den Dateinamen beim Drucken in eine Datei ab oder legt diesen fest. |
| PrintRange |
Ruft die Seitenzahlen ab, die der Benutzer zum Drucken angegeben hat, oder legt diese fest. |
| PrintToFile |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Druckausgabe an eine Datei anstatt an einen Port gesendet wird. |
| SupportsColor |
Ruft einen Wert ab, der angibt, ob dieser Drucker farbdruck unterstützt. |
| ToPage |
Ruft die Nummer der letzten zu druckende Seite ab oder legt sie fest. |
Methoden
| Name | Beschreibung |
|---|---|
| Clone() |
Erstellt eine Kopie dieser PrinterSettingsDatei. |
| CreateMeasurementGraphics() |
Gibt einen Graphics Wert zurück, der Druckerinformationen enthält, die beim Erstellen eines Druckers PrintDocumentnützlich sind. |
| CreateMeasurementGraphics(Boolean) |
Gibt eine Graphics Druckerinformation zurück, die optional den Ursprung am Rand angibt. |
| CreateMeasurementGraphics(PageSettings, Boolean) |
Erstellt eine Graphics Zuordnung zu den angegebenen Seiteneinstellungen und optional die Angabe des Ursprungs an den Rändern. |
| CreateMeasurementGraphics(PageSettings) |
Gibt einen Graphics Wert zurück, der Druckerinformationen enthält, die dem angegebenen PageSettingsElement zugeordnet sind. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetHdevmode() |
Erstellt einen Handle zu einer |
| GetHdevmode(PageSettings) |
Erstellt ein Handle für eine |
| GetHdevnames() |
Erstellt einen Handle zu einer |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IsDirectPrintingSupported(Image) |
Ruft einen Wert ab, der angibt, ob der Drucker das Drucken der angegebenen Bilddatei unterstützt. |
| IsDirectPrintingSupported(ImageFormat) |
Gibt einen Wert zurück, der angibt, ob der Drucker das angegebene Bildformat unterstützt. |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| SetHdevmode(IntPtr) |
Kopiert die relevanten Informationen aus dem angegebenen Handle und in die PrinterSettings. |
| SetHdevnames(IntPtr) |
Kopiert die relevanten Informationen aus dem angegebenen Handle und in die PrinterSettings. |
| ToString() |
Stellt Informationen zum Zeichenfolgenformular PrinterSettings bereit. |