PrinterSettings Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee geeft u informatie op over hoe een document wordt afgedrukt, inclusief de printer die het document afdrukt, wanneer u afdrukt vanuit een Windows Forms toepassing.
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
- Overname
-
PrinterSettings
- Kenmerken
- Implementeringen
Voorbeelden
In het volgende codevoorbeeld wordt een document afgedrukt op de opgegeven printer. Het voorbeeld heeft drie vereisten:
Er is een variabele met de naam
filePathingesteld op het pad van het bestand dat moet worden afgedrukt.Er is een methode met de naam
pd_PrintPage, die de PrintPage gebeurtenis afhandelt, gedefinieerd.Er is een variabele met de naam
printervan de printer ingesteld.
Gebruik de System.Drawing, System.Drawing.Printingen System.IO naamruimten voor dit voorbeeld.
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
Opmerkingen
Normaal gesproken opent u een PrinterSettings of meer PageSettings.PrinterSettingsPrintDocument.PrinterSettings eigenschappen om printerinstellingen te wijzigen. De meest voorkomende printerinstelling is PrinterName, waarmee de printer wordt opgegeven waarnaar moet worden afgedrukt.
Zie het overzicht System.Drawing.Printing naamruimte voor meer informatie over afdrukken met Windows Forms. Als u wilt afdrukken vanuit een Windows Presentation Foundation toepassing, raadpleegt u de System.Printing naamruimte.
Note
In .NET 6 en latere versies wordt het pakket System.Drawing.Common, dat dit type bevat, alleen ondersteund op Windows-besturingssystemen. Het gebruik van dit type in platformoverschrijdende apps veroorzaakt compileertijdwaarschuwingen en runtime-uitzonderingen. Zie System.Drawing.Common alleen ondersteund in Windows voor meer informatie.
Constructors
| Name | Description |
|---|---|
| PrinterSettings() |
Initialiseert een nieuw exemplaar van de PrinterSettings klasse. |
Eigenschappen
| Name | Description |
|---|---|
| CanDuplex |
Hiermee wordt een waarde opgehaald die aangeeft of de printer dubbelzijdig afdrukken ondersteunt. |
| Collate |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het afgedrukte document is gesorteerd. |
| Copies |
Hiermee kunt u het aantal exemplaren van het document ophalen of instellen dat moet worden afgedrukt. |
| DefaultPageSettings |
Hiermee haalt u de standaardpagina-instellingen voor deze printer op. |
| Duplex |
Hiermee wordt de printerinstelling opgehaald of ingesteld voor dubbelzijdig afdrukken. |
| FromPage |
Hiermee haalt u het paginanummer van de eerste pagina op of stelt u deze in om af te drukken. |
| InstalledPrinters |
Hiermee haalt u de namen op van alle printers die op de computer zijn geïnstalleerd. |
| IsDefaultPrinter |
Hiermee wordt een waarde opgehaald die aangeeft of de PrinterName eigenschap de standaardprinter aanwijst, behalve wanneer de gebruiker expliciet instelt PrinterName. |
| IsPlotter |
Hiermee wordt een waarde opgehaald die aangeeft of de printer een plotter is. |
| IsValid |
Hiermee wordt een waarde opgehaald die aangeeft of de PrinterName eigenschap een geldige printer aanwijst. |
| LandscapeAngle |
Hiermee haalt u de hoek op, in graden, dat de staande stand wordt gedraaid om de liggende stand te produceren. |
| MaximumCopies |
Hiermee haalt u het maximum aantal exemplaren op dat de printer de gebruiker in staat stelt om tegelijk af te drukken. |
| MaximumPage |
Hiermee haalt u het maximum op of stelt u het maximum FromPage in of ToPage dat kan worden geselecteerd in een PrintDialog. |
| MinimumPage |
Hiermee haalt u het minimum op of stelt u het minimum FromPage in of ToPage dat kan worden geselecteerd in een PrintDialog. |
| PaperSizes |
Hiermee haalt u de papierformaten op die door deze printer worden ondersteund. |
| PaperSources |
Hiermee haalt u de papierbronlades op die beschikbaar zijn op de printer. |
| PrinterName |
Hiermee haalt u de naam van de printer op of stelt u deze in. |
| PrinterResolutions |
Hiermee haalt u alle resoluties op die door deze printer worden ondersteund. |
| PrintFileName |
Hiermee haalt u de bestandsnaam op of stelt u deze in wanneer u afdrukt naar een bestand. |
| PrintRange |
Hiermee haalt u de paginanummers op die de gebruiker heeft opgegeven om af te drukken. |
| PrintToFile |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de afdrukuitvoer naar een bestand wordt verzonden in plaats van een poort. |
| SupportsColor |
Hiermee wordt een waarde opgehaald die aangeeft of deze printer kleurenafdruk ondersteunt. |
| ToPage |
Hiermee kunt u het nummer van de laatste pagina ophalen of instellen om af te drukken. |
Methoden
| Name | Description |
|---|---|
| Clone() |
Hiermee maakt u een kopie van deze PrinterSettings. |
| CreateMeasurementGraphics() |
Retourneert een Graphics die printerinformatie bevat die handig is bij het maken van een PrintDocument. |
| CreateMeasurementGraphics(Boolean) |
Retourneert een Graphics met printergegevens, eventueel de oorsprong aan de marges opgeven. |
| CreateMeasurementGraphics(PageSettings, Boolean) |
Hiermee maakt u een Graphics gekoppeld aan de opgegeven pagina-instellingen en geeft u desgewenst de oorsprong aan de marges op. |
| CreateMeasurementGraphics(PageSettings) |
Retourneert een Graphics met printergegevens die zijn gekoppeld aan de opgegeven PageSettings. |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetHdevmode() |
Hiermee maakt u een ingang naar een |
| GetHdevmode(PageSettings) |
Hiermee maakt u een ingang voor een |
| GetHdevnames() |
Hiermee maakt u een ingang naar een |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| IsDirectPrintingSupported(Image) |
Hiermee wordt een waarde opgehaald die aangeeft of de printer het afdrukken van het opgegeven afbeeldingsbestand ondersteunt. |
| IsDirectPrintingSupported(ImageFormat) |
Retourneert een waarde die aangeeft of de printer het afdrukken van de opgegeven afbeeldingsindeling ondersteunt. |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| SetHdevmode(IntPtr) |
Kopieert de relevante informatie uit de opgegeven ingang en naar de PrinterSettings. |
| SetHdevnames(IntPtr) |
Kopieert de relevante informatie uit de opgegeven ingang en naar de PrinterSettings. |
| ToString() |
Bevat informatie over het PrinterSettings in tekenreeksformulier. |