PrinterSettings Třída

Definice

Obor názvů:

System.Drawing.Printing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v8.0.0

Zdroj:

PrinterSettings.cs

Určuje informace o tisku dokumentu, včetně tiskárny, která ho tiskne, při tisku z model Windows Forms aplikace.

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 .

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

Při úpravě nastavení tiskárny obvykle přistupujete k PrinterSettings vlastnostem prostřednictvím PrintDocument.PrinterSettings nebo PageSettings.PrinterSettings . Nejběžnější nastavení tiskárny je PrinterName, které určuje tiskárnu, na kterou chcete tisknout.

Další informace o tisku s model Windows Forms najdete v přehledu System.Drawing.Printing oboru názvů. Pokud chcete tisknout z Windows Presentation Foundation aplikace, podívejte se na System.Printing obor názvů.

Poznámka

V rozhraní .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í na kompilaci a výjimky za běhu. Další informace najdete v tématu System.Drawing.Common podporované pouze ve Windows.

Konstruktory

PrinterSettings()

Inicializuje novou instanci PrinterSettings třídy .

Vlastnosti

CanDuplex	Získá hodnotu označující, zda tiskárna podporuje oboustranný tisk.
Collate	Získá nebo nastaví hodnotu označující, zda je tiš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 k tisku.
InstalledPrinters	Získá názvy všech tiskáren nainstalovaných v počítači.
IsDefaultPrinter	Získá hodnotu označující, zda PrinterName vlastnost určuje výchozí tiskárnu, s výjimkou případu, kdy uživatel explicitně nastaví PrinterName.
IsPlotter	Získá hodnotu označující, zda tiskárna je plotr.
IsValid	Získá hodnotu označ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í maximum FromPage nebo ToPage , které lze vybrat v objektu PrintDialog.
MinimumPage	Získá nebo nastaví minimum FromPage nebo ToPage , které lze vybrat v objektu PrintDialog.
PaperSizes	Získá formáty papíru, které jsou podporovány touto tiskárnou.
PaperSources	Získá zásobníky zdroje 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 do souboru.
PrintRange	Získá nebo nastaví čísla stránek, které uživatel zadal k tisku.
PrintToFile	Získá nebo nastaví hodnotu označující, zda je výstup tisku odeslán do souboru namísto portu.
SupportsColor	Získá hodnotu označující, zda tato tiskárna podporuje tisk barev.
ToPage	Získá nebo nastaví číslo poslední stránky k tisku.

Metody

Clone()	Vytvoří kopii tohoto PrinterSettingssouboru .
CreateMeasurementGraphics()	Vrátí hodnotu obsahující Graphics informace o tiskárně, které jsou užitečné při vytváření objektu PrintDocument.
CreateMeasurementGraphics(Boolean)	Vrátí hodnotu Graphics , která obsahuje informace o tiskárně, volitelně určující původ na okrajích.
CreateMeasurementGraphics(PageSettings)	Vrátí hodnotu Graphics , která obsahuje informace o tiskárně přidružené k zadanému PageSettingsobjektu .
CreateMeasurementGraphics(PageSettings, Boolean)	Graphics Vytvoří přidružený k zadanému nastavení stránky a volitelně určuje původ na okraji.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetHdevmode()	Vytvoří popisovač DEVMODE struktury, 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č DEVNAMES struktury, která odpovídá nastavení tiskárny.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
IsDirectPrintingSupported(Image)	Získá hodnotu označ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.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
SetHdevmode(IntPtr)	Zkopíruje příslušné informace z daného popisovače do PrinterSettings.
SetHdevnames(IntPtr)	Zkopíruje příslušné informace z daného popisovače do PrinterSettings.
ToString()	Poskytuje informace o řetězcovém formuláři PrinterSettings .

Viz také

• PrinterName
• PrinterSettings
• PrinterSettings