PageSettings 클래스

정의

한면 인쇄 페이지에 적용할 설정을 지정합니다.Specifies settings that apply to a single, printed page.

public ref class PageSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PageSettings : ICloneable
type PageSettings = class
    interface ICloneable
Public Class PageSettings
Implements ICloneable
상속
PageSettings
특성
구현

예제

다음 예에서는 PrintPage 이벤트를 처리 하 고 PrintPageEventArgsPageSettings 인수를 확인 하는 방법을 보여 줍니다.The following example demonstrates handling the PrintPage event and checking the PageSettings argument of PrintPageEventArgs. 이 코드를 사용 하려면 PrintDocument1 이라는 PrintDocument 구성 요소를 Windows Form에 추가 하 고 해당 PrintPage 이벤트를 예제의 printDocument1_PrintPage 메서드와 연결 합니다.To use this code, add a PrintDocument component named PrintDocument1 to a Windows Form and associate its PrintPage event with the printDocument1_PrintPage method in the example.

private void printDocument1_PrintPage(object sender, System.Drawing.Printing.PrintPageEventArgs e)
{
    if (e.PageSettings.Color && !printDocument1.PrinterSettings.SupportsColor)
        MessageBox.Show("Color printing not supported on selected printer.", "Printer Warning", MessageBoxButtons.OKCancel);
}
Private Sub printDocument1_PrintPage(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintPageEventArgs)  Handles printDocument1.PrintPage
    If e.PageSettings.Color AndAlso Not printDocument1.PrinterSettings.SupportsColor Then
        MessageBox.Show("Color printing not supported on selected printer.", "Printer Warning", MessageBoxButtons.OKCancel)
    End If

End Sub

설명

PageSettings 클래스는 페이지가 인쇄 되는 방법을 수정 하는 설정을 지정 하는 데 사용 됩니다.The PageSettings class is used to specify settings that modify the way a page will be printed. 일반적으로 PrintDocument.DefaultPageSettings 속성을 통해 인쇄할 모든 페이지에 대 한 기본 설정을 지정할 수 있습니다.Typically, you set default settings for all pages to be printed through the PrintDocument.DefaultPageSettings property. 페이지 별로 설정을 지정 하려면 PrintDocument.PrintPage 또는 PrintDocument.QueryPageSettings 이벤트를 처리 하 고 각각 PrintPageEventArgs 또는 QueryPageSettingsEventArgs에 포함 된 PageSettings 인수를 수정 합니다.To specify settings on a page-by-page basis, handle the PrintDocument.PrintPage or PrintDocument.QueryPageSettings event and modify the PageSettings argument included in the PrintPageEventArgs or QueryPageSettingsEventArgs, respectively.

PrintDocument 이벤트를 처리 하는 방법에 대 한 자세한 내용은 PrintDocument 클래스 개요를 참조 하세요.For more information about handling PrintDocument events, see the PrintDocument class overview. 인쇄에 대 한 자세한 내용은 System.Drawing.Printing 네임 스페이스 개요를 참조 하세요.For more information about printing, see the System.Drawing.Printing namespace overview.

생성자

PageSettings()

기본 프린터를 사용하여 PageSettings 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the PageSettings class using the default printer.

PageSettings(PrinterSettings)

지정된 프린터를 사용하여 PageSettings 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the PageSettings class using a specified printer.

속성

Bounds

Landscape 속성으로 지정한 페이지 방향을 고려하여 페이지의 크기를 가져옵니다.Gets the size of the page, taking into account the page orientation specified by the Landscape property.

Color

페이지를 컬러로 인쇄할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the page should be printed in color.

HardMarginX

페이지 왼쪽에 있는 하드 여백의 X 좌표(1/100인치)를 가져옵니다.Gets the x-coordinate, in hundredths of an inch, of the hard margin at the left of the page.

HardMarginY

페이지 위쪽에 있는 하드 여백의 Y 좌표(1/100인치)를 가져옵니다.Gets the y-coordinate, in hundredths of an inch, of the hard margin at the top of the page.

Landscape

페이지를 가로 또는 세로 방향으로 인쇄할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the page is printed in landscape or portrait orientation.

Margins

이 페이지에 대한 여백을 가져오거나 설정합니다.Gets or sets the margins for this page.

PaperSize

페이지에 대한 용지 크기를 가져오거나 설정합니다.Gets or sets the paper size for the page.

PaperSource

페이지의 용지 공급을 가져오거나 설정합니다(예: 프린터의 상단 용지함).Gets or sets the page's paper source; for example, the printer's upper tray.

PrintableArea

프린터에서 인쇄할 수 있는 페이지 영역의 경계를 가져옵니다.Gets the bounds of the printable area of the page for the printer.

PrinterResolution

페이지에 대한 프린터 해상도를 가져오거나 설정합니다.Gets or sets the printer resolution for the page.

PrinterSettings

해당 페이지와 관련된 프린터 설정을 가져오거나 설정합니다.Gets or sets the printer settings associated with the page.

메서드

Clone()

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

CopyToHdevmode(IntPtr)

PageSettings에서 지정된 DEVMODE 구조체로 관련 정보를 복사합니다.Copies the relevant information from the PageSettings to the specified DEVMODE structure.

Equals(Object)

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

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

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

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

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

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

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

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

지정된 DEVMODE 구조체에서 PageSettings로 관련 정보를 복사합니다.Copies relevant information to the PageSettings from the specified DEVMODE structure.

ToString()

PageSettings를 문자열 형식으로 변환합니다.Converts the PageSettings to string form.

적용 대상

추가 정보