PrinterSettings 클래스

정의

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
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
Public Class PrinterSettings
Implements ICloneable
상속
PrinterSettings
특성
구현

예제

다음 코드 예제에서는 지정된 된 프린터에서 문서를 인쇄 합니다.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.

  • PrintPage 이벤트를 처리 하는 pd_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, System.Drawing.PrintingSystem.IO 네임 스페이스를 사용 합니다.Use 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
   

설명

일반적으로 PrintDocument.PrinterSettings 또는 PageSettings.PrinterSettings 속성을 통해 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 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the PrinterSettings class.

속성

CanDuplex

프린터에서 양면 인쇄를 지원하는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the printer supports double-sided printing.

Collate

문서가 한 부씩 인쇄되는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the printed document is collated.

Copies

인쇄할 문서의 매수를 가져오거나 설정합니다.Gets or sets the number of copies of the document to print.

DefaultPageSettings

이 프린터의 기본 페이지 설정을 가져옵니다.Gets the default page settings for this printer.

Duplex

양면 인쇄에 대한 프린터 설정을 가져오거나 설정합니다.Gets or sets the printer setting for double-sided printing.

FromPage

인쇄할 첫 페이지의 페이지 번호를 가져오거나 설정합니다.Gets or sets the page number of the first page to print.

InstalledPrinters

컴퓨터에 설치된 모든 프린터의 이름을 가져옵니다.Gets the names of all printers installed on the computer.

IsDefaultPrinter

사용자가 명시적으로 PrinterName을 설정할 때를 제외하고 PrinterName 속성이 기본 프린터를 지정하는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the PrinterName property designates the default printer, except when the user explicitly sets PrinterName.

IsPlotter

프린터가 플로터인지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the printer is a plotter.

IsValid

PrinterName 속성이 올바른 프린터를 지정할지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the PrinterName property designates a valid printer.

LandscapeAngle

세로 방향이 가로 방향으로 회전되는 각도를 가져옵니다.Gets the angle, in degrees, that the portrait orientation is rotated to produce the landscape orientation.

MaximumCopies

프린터에는 사용자가 한 번에 인쇄할 수 있는 최대 매수를 가져옵니다.Gets the maximum number of copies that the printer enables the user to print at a time.

MaximumPage

FromPage에서 선택할 수 있는 최대 ToPage 또는 PrintDialog를 가져오거나 설정합니다.Gets or sets the maximum FromPage or ToPage that can be selected in a PrintDialog.

MinimumPage

FromPage에서 선택할 수 있는 최소 ToPage 또는 PrintDialog를 가져오거나 설정합니다.Gets or sets the minimum FromPage or ToPage that can be selected in a PrintDialog.

PaperSizes

이 프린터에서 지 원하는 용지 크기를 가져옵니다.Gets the paper sizes that are supported by this printer.

PaperSources

프린터에서 사용할 수 있는 용지 공급함을 가져옵니다.Gets the paper source trays that are available on the printer.

PrinterName

사용할 프린터 이름을 가져오거나 설정합니다.Gets or sets the name of the printer to use.

PrinterResolutions

이 프린터에서 지원하는 모든 해상도를 가져옵니다.Gets all the resolutions that are supported by this printer.

PrintFileName

파일로 인쇄 하는 경우 파일 이름을 가져오거나 설정 합니다.Gets or sets the file name, when printing to a file.

PrintRange

인쇄되도록 지정한 페이지 번호를 가져오거나 설정합니다.Gets or sets the page numbers that the user has specified to be printed.

PrintToFile

인쇄 출력이 포트 대신 파일에 전달되는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the printing output is sent to a file instead of a port.

SupportsColor

이 프린터에서 컬러 인쇄를 지원하는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether this printer supports color printing.

ToPage

인쇄할 마지막 페이지의 수를 가져오거나 설정 합니다.Gets or sets the number of the last page to print.

메서드

Clone()

PrinterSettings의 복사본을 만듭니다.Creates a copy of this PrinterSettings.

CreateMeasurementGraphics()

Graphics를 만들 때 유용한 프린터 정보를 포함하는 PrintDocument를 반환합니다.Returns a Graphics that contains printer information that is useful when creating a PrintDocument.

CreateMeasurementGraphics(Boolean)

여백의 원점을 선택적으로 지정하여 프린터 정보를 포함하는 Graphics를 반환합니다.Returns a Graphics that contains printer information, optionally specifying the origin at the margins.

CreateMeasurementGraphics(PageSettings)

지정된 Graphics와 연결된 프린터 정보를 포함하는 PageSettings를 반환합니다.Returns a Graphics that contains printer information associated with the specified PageSettings.

CreateMeasurementGraphics(PageSettings, Boolean)

지정된 페이지 설정과 연결된 Graphics를 만들고 여백의 원점을 선택적으로 지정합니다.Creates a Graphics associated with the specified page settings and optionally specifying the origin at the margins.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetHdevmode()

프린터 설정에 해당하는 DEVMODE 구조체에 대한 핸들을 만듭니다.Creates a handle to a DEVMODE structure that corresponds to the printer settings.

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()

프린터 설정에 해당하는 DEVNAMES 구조체에 대한 핸들을 만듭니다.Creates a handle to a DEVNAMES structure that corresponds to the printer settings.

GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
IsDirectPrintingSupported(Image)

프린터에서 지정된 이미지 파일 인쇄를 지원하는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the printer supports printing the specified image file.

IsDirectPrintingSupported(ImageFormat)

프린터에서 지정된 이미지 형식 인쇄를 지원하는지 여부를 나타내는 값을 반환합니다.Returns a value indicating whether the printer supports printing the specified image format.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
SetHdevmode(IntPtr)

지정된 핸들에 있는 관련 정보를 PrinterSettings에 복사합니다.Copies the relevant information out of the given handle and into the PrinterSettings.

SetHdevnames(IntPtr)

지정된 핸들에 있는 관련 정보를 PrinterSettings에 복사합니다.Copies the relevant information out of the given handle and into the PrinterSettings.

ToString()

PrinterSettings에 대한 정보를 문자열 형식으로 제공합니다.Provides information about the PrinterSettings in string form.

적용 대상

추가 정보