PrinterSettings PrinterSettings PrinterSettings PrinterSettings Class

Определение

Задает сведения о способе печати документа, включая принтер, выполняющий печать из приложения Windows Forms.Specifies information about how a document is printed, including the printer that prints it, when printing from a Windows Forms application.

public ref class PrinterSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
type PrinterSettings = class
    interface ICloneable
Public Class PrinterSettings
Implements ICloneable
Наследование
PrinterSettingsPrinterSettingsPrinterSettingsPrinterSettings
Атрибуты
Реализации

Примеры

В следующем примере кода выполняется печать документа на указанном принтере.The following code example prints a document on the specified printer. В примере есть три предварительных требования:The example has three prerequisites:

  • Переменной filePath присваивается путь к файлу для печати.A variable named filePath has been set to the path of the file to print.

  • Был определен метод pd_PrintPageс именем, который PrintPage обрабатывает событие.A method named pd_PrintPage, which handles the PrintPage event, has been defined.

  • Переменной с именем printer присваивается имя принтера.A variable named printer has been set to the printer's name.

Для этого примера System.Drawing.Printingиспользуйте пространства System.IO имен ,и.System.DrawingUse the System.Drawing, System.Drawing.Printing, and System.IO namespaces for this example.

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 можно использовать свойства или.Typically, you access a PrinterSettings through PrintDocument.PrinterSettings or PageSettings.PrinterSettings properties to modify printer settings. Наиболее распространенным параметром принтера PrinterNameявляется, который указывает принтер для печати.The most common printer setting is PrinterName, which specifies the printer to print to.

Дополнительные сведения о печати с помощью Windows Forms см. в System.Drawing.Printing разделе Общие сведения о пространстве имен.For more information about printing with Windows Forms, see the System.Drawing.Printing namespace overview. Если вы хотите выполнить печать из Windows Presentation Foundation приложения, см. раздел System.Printing пространство имен.If you wish to print from a Windows Presentation Foundation application, see the System.Printing namespace.

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

PrinterSettings() PrinterSettings() PrinterSettings() PrinterSettings()

Инициализирует новый экземпляр класса PrinterSettings.Initializes a new instance of the PrinterSettings class.

Свойства

CanDuplex CanDuplex CanDuplex CanDuplex

Получает значение, показывающее, поддерживает ли принтер двухстороннюю печать.Gets a value indicating whether the printer supports double-sided printing.

Collate Collate Collate Collate

Получает или задает значение, показывающее, выполняется ли разбор документа по копиям.Gets or sets a value indicating whether the printed document is collated.

Copies Copies Copies Copies

Получает или задает количество копий документа, которое необходимо вывести на печать.Gets or sets the number of copies of the document to print.

DefaultPageSettings DefaultPageSettings DefaultPageSettings DefaultPageSettings

Получает параметры страницы по умолчанию для принтера.Gets the default page settings for this printer.

Duplex Duplex Duplex Duplex

Получает или задает параметры принтера для двухсторонней печати.Gets or sets the printer setting for double-sided printing.

FromPage FromPage FromPage FromPage

Получает или задает необходимость печати номера страницы на первой странице документа.Gets or sets the page number of the first page to print.

InstalledPrinters InstalledPrinters InstalledPrinters InstalledPrinters

Получает названия всех принтеров, установленных на компьютере.Gets the names of all printers installed on the computer.

IsDefaultPrinter IsDefaultPrinter IsDefaultPrinter IsDefaultPrinter

Получает значение, определяющее необходимость назначения при помощи свойства PrinterName принтера, используемого по умолчанию, за исключением случаев явного указания пользователем свойства PrinterName.Gets a value indicating whether the PrinterName property designates the default printer, except when the user explicitly sets PrinterName.

IsPlotter IsPlotter IsPlotter IsPlotter

Получает значение, показывающее, является ли принтер плоттером.Gets a value indicating whether the printer is a plotter.

IsValid IsValid IsValid IsValid

Получает значение, определяющее, назначает ли свойство PrinterName действительный принтер.Gets a value indicating whether the PrinterName property designates a valid printer.

LandscapeAngle LandscapeAngle LandscapeAngle LandscapeAngle

Получает угол поворота страницы в градусах от горизонтальной к вертикальной ориентации.Gets the angle, in degrees, that the portrait orientation is rotated to produce the landscape orientation.

MaximumCopies MaximumCopies MaximumCopies MaximumCopies

Получает максимально допустимое число копий, которое пользователь может напечатать на данном принтере одновременно.Gets the maximum number of copies that the printer enables the user to print at a time.

MaximumPage MaximumPage MaximumPage MaximumPage

Получает или задает максимальное значение свойства FromPage или свойства ToPage, которое может быть выбрано в PrintDialog.Gets or sets the maximum FromPage or ToPage that can be selected in a PrintDialog.

MinimumPage MinimumPage MinimumPage MinimumPage

Получает или задает минимальное значение свойства FromPage или свойства ToPage, которое может быть выбрано в PrintDialog.Gets or sets the minimum FromPage or ToPage that can be selected in a PrintDialog.

PaperSizes PaperSizes PaperSizes PaperSizes

Получает размеры бумаги, поддерживаемые принтером.Gets the paper sizes that are supported by this printer.

PaperSources PaperSources PaperSources PaperSources

Получает допустимые при работе с принтером источники бумаги.Gets the paper source trays that are available on the printer.

PrinterName PrinterName PrinterName PrinterName

Получает или задает имя используемого принтера.Gets or sets the name of the printer to use.

PrinterResolutions PrinterResolutions PrinterResolutions PrinterResolutions

Получает разрешения, поддерживаемые принтером.Gets all the resolutions that are supported by this printer.

PrintFileName PrintFileName PrintFileName PrintFileName

Получает или задает имя файла во время печати в файл.Gets or sets the file name, when printing to a file.

PrintRange PrintRange PrintRange PrintRange

Получает или задает номера страниц, отправленных на печать пользователем.Gets or sets the page numbers that the user has specified to be printed.

PrintToFile PrintToFile PrintToFile PrintToFile

Получает или задает значение, определяющее, выводятся данные на печать или отправляются не в порт, а в файл.Gets or sets a value indicating whether the printing output is sent to a file instead of a port.

SupportsColor SupportsColor SupportsColor SupportsColor

Получает значение, показывающее, поддерживает принтер цветную печать или нет.Gets a value indicating whether this printer supports color printing.

ToPage ToPage ToPage ToPage

Получает или задает номер последней страницы, выводимой на печать.Gets or sets the number of the last page to print.

Методы

Clone() Clone() Clone() Clone()

Создает копию данного объекта PrinterSettings.Creates a copy of this PrinterSettings.

CreateMeasurementGraphics() CreateMeasurementGraphics() CreateMeasurementGraphics() CreateMeasurementGraphics()

Возвращает объект Graphics, содержащий сведения о принтере, используемые при создании PrintDocument.Returns a Graphics that contains printer information that is useful when creating a PrintDocument.

CreateMeasurementGraphics(Boolean) CreateMeasurementGraphics(Boolean) CreateMeasurementGraphics(Boolean) CreateMeasurementGraphics(Boolean)

Возвращает объект Graphics со сведениями о принтере, дополнительно указывая исходный объект на полях.Returns a Graphics that contains printer information, optionally specifying the origin at the margins.

CreateMeasurementGraphics(PageSettings) CreateMeasurementGraphics(PageSettings) CreateMeasurementGraphics(PageSettings) CreateMeasurementGraphics(PageSettings)

Возвращает объект Graphics, содержащий сведения о принтере, связанные с указанным PageSettings.Returns a Graphics that contains printer information associated with the specified PageSettings.

CreateMeasurementGraphics(PageSettings, Boolean) CreateMeasurementGraphics(PageSettings, Boolean) CreateMeasurementGraphics(PageSettings, Boolean) CreateMeasurementGraphics(PageSettings, Boolean)

Создает Graphics, связанный с указанными параметрами страницы и дополнительно указывающий исходный объект на полях.Creates a Graphics associated with the specified page settings and optionally specifying the origin at the margins.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetHdevmode() GetHdevmode() GetHdevmode() GetHdevmode()

Создает дескриптор структуры DEVMODE, относящейся к параметрам принтера.Creates a handle to a DEVMODE structure that corresponds to the printer settings.

GetHdevmode(PageSettings) GetHdevmode(PageSettings) GetHdevmode(PageSettings) GetHdevmode(PageSettings)

Создает дескриптор структуры DEVMODE, относящейся к параметрам принтера и страницы, заданным с помощью параметра pageSettings.Creates a handle to a DEVMODE structure that corresponds to the printer and the page settings specified through the pageSettings parameter.

GetHdevnames() GetHdevnames() GetHdevnames() GetHdevnames()

Создает дескриптор структуры DEVNAMES, относящейся к параметрам принтера.Creates a handle to a DEVNAMES structure that corresponds to the printer settings.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
IsDirectPrintingSupported(Image) IsDirectPrintingSupported(Image) IsDirectPrintingSupported(Image) IsDirectPrintingSupported(Image)

Получает значение, показывающее, поддерживает ли принтер печать указанного файла изображения.Gets a value indicating whether the printer supports printing the specified image file.

IsDirectPrintingSupported(ImageFormat) IsDirectPrintingSupported(ImageFormat) IsDirectPrintingSupported(ImageFormat) IsDirectPrintingSupported(ImageFormat)

Возвращает значение, показывающее, поддерживает ли принтер печать указанного формата изображения.Returns a value indicating whether the printer supports printing the specified image format.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
SetHdevmode(IntPtr) SetHdevmode(IntPtr) SetHdevmode(IntPtr) SetHdevmode(IntPtr)

Копирует релевантную информацию из указанного дескриптора в PrinterSettings.Copies the relevant information out of the given handle and into the PrinterSettings.

SetHdevnames(IntPtr) SetHdevnames(IntPtr) SetHdevnames(IntPtr) SetHdevnames(IntPtr)

Копирует релевантную информацию из указанного дескриптора в PrinterSettings.Copies the relevant information out of the given handle and into the PrinterSettings.

ToString() ToString() ToString() ToString()

Предоставляет сведения о PrinterSettings в форме строки.Provides information about the PrinterSettings in string form.

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

Дополнительно