PrinterSettings Класс

Определение

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

System.Drawing.Printing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

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

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 или PageSettings.PrinterSettingsPrintDocument.PrinterSettings осуществляется для изменения параметров принтера. Наиболее распространенным параметром принтера является PrinterName, который указывает принтер для печати.

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

Примечание

В .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	Получает или задает минимальное значение свойства FromPage или свойства ToPage, которое может быть выбрано в PrintDialog.
PaperSizes	Получает размеры бумаги, поддерживаемые принтером.
PaperSources	Получает допустимые при работе с принтером источники бумаги.
PrinterName	Получает или задает имя используемого принтера.
PrinterResolutions	Получает разрешения, поддерживаемые принтером.
PrintFileName	Получает или задает имя файла во время печати в файл.
PrintRange	Получает или задает номера страниц, отправленных на печать пользователем.
PrintToFile	Получает или задает значение, определяющее, выводятся данные на печать или отправляются не в порт, а в файл.
SupportsColor	Получает значение, показывающее, поддерживает принтер цветную печать или нет.
ToPage	Получает или задает номер последней страницы, выводимой на печать.

Методы

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

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

• PrinterName
• PrinterSettings
• PrinterSettings