Sdílet prostřednictvím


PrinterSettings Třída

Definice

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
[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
Dědičnost
PrinterSettings
Atributy
Implementuje

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 .

Platí pro

Viz také