Поделиться через


PrinterSettings Класс

Определение

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

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
Наследование
PrinterSettings
Атрибуты
Реализации

Примеры

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

  • Переменной с именем 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 в форме строки.

Применяется к

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