PrinterSettings Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Anger information om hur ett dokument skrivs ut, inklusive den skrivare som skriver ut det, när det skrivs ut från ett Windows Forms program.
public ref class PrinterSettings : ICloneable
public class PrinterSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
[System.Serializable]
public class PrinterSettings : ICloneable
type PrinterSettings = class
interface 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
- Arv
-
PrinterSettings
- Attribut
- Implementeringar
Exempel
I följande kodexempel skrivs ett dokument ut på den angivna skrivaren. Exemplet har tre förutsättningar:
En variabel med namnet
filePathhar angetts till sökvägen till filen som ska skrivas ut.En metod med namnet
pd_PrintPage, som hanterar PrintPage händelsen, har definierats.En variabel med namnet
printerhar angetts till skrivarens namn.
System.DrawingAnvänd namnrymderna , System.Drawing.Printingoch System.IO för det här exemplet.
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
Kommentarer
Vanligtvis får du åtkomst till en PrinterSettings genom PrintDocument.PrinterSettings - eller PageSettings.PrinterSettings -egenskaper för att ändra skrivarinställningarna. Den vanligaste skrivarinställningen är PrinterName, som anger vilken skrivare som ska skrivas ut till.
Mer information om hur du skriver ut med Windows Forms finns i översikten System.Drawing.Printing namnområde. Om du vill skriva ut från ett Windows Presentation Foundation program läser du namnområdet System.Printing.
Note
I .NET 6 och senare versioner stöds endast System.Drawing.Common-paketet, som innehåller den här typen, på Windows-operativsystem. Användning av den här typen i plattformsoberoende appar orsakar kompileringstidsvarningar och körningsfel. Mer information finns i System.Drawing.Common som endast stöds i Windows.
Konstruktorer
| Name | Description |
|---|---|
| PrinterSettings() |
Initierar en ny instans av PrinterSettings klassen. |
Egenskaper
| Name | Description |
|---|---|
| CanDuplex |
Hämtar ett värde som anger om skrivaren stöder dubbelsidig utskrift. |
| Collate |
Hämtar eller anger ett värde som anger om det utskrivna dokumentet är sorterat. |
| Copies |
Hämtar eller anger hur många kopior av dokumentet som ska skrivas ut. |
| DefaultPageSettings |
Hämtar standardsidans inställningar för den här skrivaren. |
| Duplex |
Hämtar eller ställer in skrivarinställningen för dubbelsidig utskrift. |
| FromPage |
Hämtar eller anger sidnumret för den första sidan som ska skrivas ut. |
| InstalledPrinters |
Hämtar namnen på alla skrivare som är installerade på datorn. |
| IsDefaultPrinter |
Hämtar ett värde som anger om PrinterName egenskapen anger standardskrivaren, förutom när användaren uttryckligen anger PrinterName. |
| IsPlotter |
Hämtar ett värde som anger om skrivaren är en plotter. |
| IsValid |
Hämtar ett värde som anger om egenskapen PrinterName anger en giltig skrivare. |
| LandscapeAngle |
Hämtar vinkeln, i grader, att stående orientering roteras för att producera liggande orientering. |
| MaximumCopies |
Hämtar det maximala antalet kopior som skrivaren gör att användaren kan skriva ut åt gången. |
| MaximumPage |
Hämtar eller anger maximalt FromPage eller ToPage som kan väljas i en PrintDialog. |
| MinimumPage |
Hämtar eller anger minimivärdet FromPage eller ToPage som kan väljas i en PrintDialog. |
| PaperSizes |
Hämtar de pappersstorlekar som stöds av den här skrivaren. |
| PaperSources |
Hämtar papperskällans fack som är tillgängliga på skrivaren. |
| PrinterName |
Hämtar eller anger namnet på skrivaren som ska användas. |
| PrinterResolutions |
Hämtar alla upplösningar som stöds av den här skrivaren. |
| PrintFileName |
Hämtar eller anger filnamnet när du skriver ut till en fil. |
| PrintRange |
Hämtar eller anger de sidnummer som användaren har angett som ska skrivas ut. |
| PrintToFile |
Hämtar eller anger ett värde som anger om utskriftsutdata skickas till en fil i stället för en port. |
| SupportsColor |
Hämtar ett värde som anger om den här skrivaren stöder färgutskrift. |
| ToPage |
Hämtar eller anger numret på den sista sidan som ska skrivas ut. |
Metoder
| Name | Description |
|---|---|
| Clone() |
Skapar en kopia av den här PrinterSettings. |
| CreateMeasurementGraphics() |
Returnerar en Graphics som innehåller skrivarinformation som är användbar när du skapar en PrintDocument. |
| CreateMeasurementGraphics(Boolean) |
Returnerar en Graphics som innehåller skrivarinformation, om du vill ange ursprunget vid marginalerna. |
| CreateMeasurementGraphics(PageSettings, Boolean) |
Skapar en Graphics associerad med de angivna sidinställningarna och kan också ange ursprunget vid marginalerna. |
| CreateMeasurementGraphics(PageSettings) |
Returnerar en Graphics som innehåller skrivarinformation som är associerad med angiven PageSettings. |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetHdevmode() |
Skapar ett handtag till en |
| GetHdevmode(PageSettings) |
Skapar ett handtag till en |
| GetHdevnames() |
Skapar ett handtag till en |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| IsDirectPrintingSupported(Image) |
Hämtar ett värde som anger om skrivaren stöder utskrift av den angivna bildfilen. |
| IsDirectPrintingSupported(ImageFormat) |
Returnerar ett värde som anger om skrivaren stöder utskrift av det angivna bildformatet. |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| SetHdevmode(IntPtr) |
Kopierar relevant information från det angivna handtaget och till PrinterSettings. |
| SetHdevnames(IntPtr) |
Kopierar relevant information från det angivna handtaget och till PrinterSettings. |
| ToString() |
Innehåller information om PrinterSettings i strängformuläret. |