PrinterSettings Класс

Определение

Пространство имен:

System.Drawing.Printing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v11.0.0-preview.7.26381.103

Исходный код:

PrinterSettings.cs

Указывает сведения о том, как печатается документ, включая принтер, который печатает его при печати из приложения Windows Forms.

public ref class PrinterSettings : ICloneable

public class PrinterSettings : ICloneable

type PrinterSettings = class
    interface ICloneable

Public Class PrinterSettings
Implements ICloneable

Наследование

Object

PrinterSettings

Реализации

ICloneable

Примеры

В следующем примере кода документ печатается на указанном принтере. В примере есть три предварительных требования:

• Для печати задан путь к файлу с именем filePath переменной.

• Определен метод с именем pd_PrintPage, который обрабатывает PrintPage событие.

• Для переменной с именем printer принтера задано имя принтера.

System.Drawing System.Drawing.PrintingИспользуйте пространства имен и 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

Комментарии

Как правило, вы обращаетесь к PrinterSettings свойствам или PrintDocument.PrinterSettings черезPageSettings.PrinterSettings, чтобы изменить параметры принтера. Наиболее распространенным параметром принтера является PrinterName, который указывает принтер для печати.

Дополнительные сведения о печати с помощью Windows Forms см. в обзоре System.Drawing.Printing пространства имен. Если вы хотите распечатать из приложения Windows Presentation Foundation, просмотрите System.Printing пространство имен.

Note

В .NET 6 и более поздних версиях пакет System.Drawing.Common, который включает этот тип, поддерживается только в операционных системах Windows. Использование этого типа в кроссплатформенных приложениях вызывает предупреждения во время компиляции и исключения во время выполнения. Дополнительные сведения см. в статье System.Drawing.Common, поддерживаемой только в Windows.

Конструкторы

Имя	Описание
PrinterSettings()	Инициализирует новый экземпляр класса PrinterSettings.

Свойства

Имя	Описание
CanDuplex	Возвращает значение, указывающее, поддерживает ли принтер двойную печать.
Collate	Возвращает или задает значение, указывающее, сопоставляется ли печатный документ.
Copies	Возвращает или задает количество копий документа для печати.
DefaultPageSettings	Возвращает параметры страницы по умолчанию для этого принтера.
Duplex	Возвращает или задает параметр принтера для двойной печати.
FromPage	Возвращает или задает номер страницы первой страницы для печати.
InstalledPrinters	Возвращает имена всех принтеров, установленных на компьютере.
IsDefaultPrinter	Возвращает значение, указывающее, присваивается ли PrinterName свойство принтеру по умолчанию, за исключением случаев, когда пользователь явно задает PrinterName.
IsPlotter	Возвращает значение, указывающее, является ли принтер графиком.
IsValid	Возвращает значение, указывающее, назначено ли PrinterName свойство допустимым принтером.
LandscapeAngle	Получает угол( в градусах), в который поворачивается книжная ориентация для создания альбомной ориентации.
MaximumCopies	Получает максимальное количество копий, которое принтер позволяет пользователю печатать за раз.
MaximumPage	Возвращает или задает максимальное FromPage значение или ToPage значение, которое можно выбрать в объекте PrintDialog.
MinimumPage	Возвращает или задает минимальный или FromPageToPage выбранный в объекте PrintDialog.
PaperSizes	Возвращает размеры бумаги, поддерживаемые этим принтером.
PaperSources	Возвращает исходные лотки бумаги, доступные на принтере.
PrinterName	Возвращает или задает имя используемого принтера.
PrinterResolutions	Возвращает все разрешения, поддерживаемые этим принтером.
PrintFileName	Возвращает или задает имя файла при печати в файл.
PrintRange	Возвращает или задает номера страниц, которые пользователь указал для печати.
PrintToFile	Возвращает или задает значение, указывающее, отправляются ли выходные данные печати в файл вместо порта.
SupportsColor	Возвращает значение, указывающее, поддерживает ли этот принтер цветную печать.
ToPage	Возвращает или задает число последней страницы для печати.

Методы

Имя	Описание
Clone()	Создает копию этого PrinterSettingsобъекта.
CreateMeasurementGraphics()	Возвращает сведения Graphics о принтере, которые полезны при создании PrintDocument.
CreateMeasurementGraphics(Boolean)	Возвращает значение Graphics , содержащее сведения о принтере, при необходимости указывающее источник на полях.
CreateMeasurementGraphics(PageSettings, Boolean)	Создает связанный Graphics с указанными параметрами страницы и при необходимости указывает источник на полях.
CreateMeasurementGraphics(PageSettings)	Возвращает значение Graphics , содержащее сведения о принтере, связанные с указанным PageSettings.
GetHdevmode()	Создает дескриптор DEVMODE структуры, соответствующей параметрам принтера.
GetHdevmode(PageSettings)	Создает дескриптор DEVMODE структуры, которая соответствует принтеру и параметрам страницы, указанным через pageSettings параметр.
GetHdevnames()	Создает дескриптор DEVNAMES структуры, соответствующей параметрам принтера.
IsDirectPrintingSupported(Image)	Возвращает значение, указывающее, поддерживает ли принтер печать указанного файла изображения.
IsDirectPrintingSupported(ImageFormat)	Возвращает значение, указывающее, поддерживает ли принтер печать указанного формата изображения.
SetHdevmode(IntPtr)	Копирует соответствующие сведения из заданного дескриптора и в PrinterSettingsнего.
SetHdevnames(IntPtr)	Копирует соответствующие сведения из заданного дескриптора и в PrinterSettingsнего.
ToString()	Предоставляет сведения о строковой PrinterSettings форме.

См. также раздел

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