PrinterSettings Třída

Definice

Obor názvů:

System.Drawing.Printing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v11.0.0-rc.1.26425.128

Zdroj:

PrinterSettings.cs

Určuje informace o tom, jak se dokument vytiskne, včetně tiskárny, která ho vytiskne, při tisku z aplikace model Windows Forms.

public ref class PrinterSettings : ICloneable

public class PrinterSettings : ICloneable

type PrinterSettings = class
    interface ICloneable

Public Class PrinterSettings
Implements ICloneable

Dědičnost

Object

PrinterSettings

Implementuje

ICloneable

Příklady

Následující příklad kódu vytiskne dokument na zadané tiskárně. Příklad má tři požadavky:

• Proměnná s názvem filePath byla nastavena na cestu k souboru, který se má vytisknout.

• Byla definována metoda s názvem pd_PrintPage, která zpracovává PrintPage událost.

• Proměnná s názvem printer byla nastavena na název tiskárny.

V tomto příkladu System.Drawingpoužijte obory názvů , System.Drawing.Printinga System.IO obory názvů.

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

Poznámky

K úpravě PrinterSettings nastavení tiskárny obvykle přistupujete prostřednictvím PrintDocument.PrinterSettings nebo PageSettings.PrinterSettings vlastnostmi. Nejběžnější nastavení tiskárny je PrinterName, které určuje tiskárnu k tisku.

Další informace o tisku pomocí Modelu model Windows Forms naleznete v přehledu System.Drawing.Printing oboru názvů. Pokud chcete tisknout z aplikace Windows Presentation Foundation, přečtěte si System.Printing obor názvů.

Note

V .NET 6 a novějších verzích je balíček System.Drawing.Common, který obsahuje tento typ, podporován pouze v operačních systémech Windows. Použití tohoto typu v multiplatformních aplikacích způsobuje upozornění v době kompilace a výjimky za běhu. Další informace naleznete v tématu System.Drawing.Common podporován pouze ve Windows.

Konstruktory

Name	Description
PrinterSettings()	Inicializuje novou instanci PrinterSettings třídy.

Vlastnosti

Name	Description
CanDuplex	Získá hodnotu určující, zda tiskárna podporuje oboustranný tisk.
Collate	Získá nebo nastaví hodnotu určující, zda je vytištěný dokument kompletován.
Copies	Získá nebo nastaví počet kopií dokumentu k tisku.
DefaultPageSettings	Získá výchozí nastavení stránky pro tuto tiskárnu.
Duplex	Získá nebo nastaví nastavení tiskárny pro oboustranný tisk.
FromPage	Získá nebo nastaví číslo stránky první stránky, která se má vytisknout.
InstalledPrinters	Získá názvy všech tiskáren nainstalovaných v počítači.
IsDefaultPrinter	Získá hodnotu určující, zda PrinterName vlastnost určuje výchozí tiskárnu, s výjimkou případů, kdy uživatel explicitně nastaví PrinterName.
IsPlotter	Získá hodnotu určující, zda je tiskárna plotter.
IsValid	Získá hodnotu určující, zda PrinterName vlastnost určuje platnou tiskárnu.
LandscapeAngle	Získá úhel ve stupních, že orientace na výšku je otočena tak, aby vznikla orientace na šířku.
MaximumCopies	Získá maximální počet kopií, které tiskárna umožňuje uživateli tisknout najednou.
MaximumPage	Získá nebo nastaví maximální FromPage nebo ToPage které lze vybrat v objektu PrintDialog.
MinimumPage	Získá nebo nastaví minimální FromPage nebo ToPage které lze vybrat v objektu PrintDialog.
PaperSizes	Získá formáty papíru podporované touto tiskárnou.
PaperSources	Získá zdrojové zásobníky papíru, které jsou k dispozici na tiskárně.
PrinterName	Získá nebo nastaví název tiskárny, která se má použít.
PrinterResolutions	Získá všechna rozlišení podporovaná touto tiskárnou.
PrintFileName	Získá nebo nastaví název souboru při tisku na soubor.
PrintRange	Získá nebo nastaví čísla stránek, které uživatel určil k tisku.
PrintToFile	Získá nebo nastaví hodnotu určující, zda je výstup tisku odeslán do souboru místo portu.
SupportsColor	Získá hodnotu určující, zda tato tiskárna podporuje barevný tisk.
ToPage	Získá nebo nastaví číslo poslední stránky, která se má vytisknout.

Metody

Name	Description
Clone()	Vytvoří kopii tohoto PrinterSettingssouboru .
CreateMeasurementGraphics()	Graphics Vrátí hodnotu obsahující informace o tiskárně, které jsou užitečné při vytváření .PrintDocument
CreateMeasurementGraphics(Boolean)	Graphics Vrátí hodnotu obsahující informace o tiskárně, volitelně určující původ na okraji.
CreateMeasurementGraphics(PageSettings, Boolean)	Vytvoří přidruženou Graphics k zadanému nastavení stránky a volitelně určí původ na okraji.
CreateMeasurementGraphics(PageSettings)	Graphics Vrátí hodnotu obsahující informace o tiskárně přidružené k zadanému PageSettings.
GetHdevmode()	Vytvoří popisovač struktury DEVMODE , která odpovídá nastavení tiskárny.
GetHdevmode(PageSettings)	Vytvoří popisovač DEVMODE struktury, která odpovídá tiskárně a nastavení stránky zadané prostřednictvím parametru pageSettings .
GetHdevnames()	Vytvoří popisovač struktury DEVNAMES , která odpovídá nastavení tiskárny.
IsDirectPrintingSupported(Image)	Získá hodnotu určující, zda tiskárna podporuje tisk zadaného souboru obrázku.
IsDirectPrintingSupported(ImageFormat)	Vrátí hodnotu určující, zda tiskárna podporuje tisk zadaného formátu obrázku.
SetHdevmode(IntPtr)	Zkopíruje příslušné informace z daného popisovače a do příslušného PrinterSettingspopisovače .
SetHdevnames(IntPtr)	Zkopíruje příslušné informace z daného popisovače a do příslušného PrinterSettingspopisovače .
ToString()	Poskytuje informace o řetězcovém formuláři PrinterSettings .

Viz také

• PrinterName
• System.Drawing.Printing.PrintDocument.PrinterSettings
• System.Drawing.Printing.PageSettings.PrinterSettings