PageSettings 类

定义

命名空间:

System.Drawing.Printing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

Source:

PageSettings.cs

指定应用于单页打印的设置。

public ref class PageSettings : ICloneable

public class PageSettings : ICloneable

type PageSettings = class
    interface ICloneable

Public Class PageSettings
Implements ICloneable

继承

Object

PageSettings

实现

ICloneable

示例

以下示例演示如何处理 PrintPage 事件并检查 PageSettings 的参数 PrintPageEventArgs。 若要使用此代码，请将名为 的组件添加到 PrintDocument Windows 窗体，并将其PrintPage事件与printDocument1_PrintPage示例中的 方法PrintDocument1相关联。

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 用于指定修改页面打印方式的设置。 通常，为要通过 PrintDocument.DefaultPageSettings 属性打印的所有页面设置默认设置。 若要逐页指定设置，请分别处理 PrintDocument.PrintPage 或 PrintDocument.QueryPageSettings 事件并修改 PageSettings 或 QueryPageSettingsEventArgs中包含的PrintPageEventArgs参数。

有关处理 PrintDocument 事件的详细信息，请参阅 PrintDocument 类概述。 有关打印的详细信息，请参阅 System.Drawing.Printing 命名空间概述。

注意

在 .NET 6 及更高版本中， System.Drawing.Common 包（包括此类型）仅在 Windows 操作系统上受支持。 在跨平台应用中使用此类型会导致编译时警告和运行时异常。 有关详细信息，请参阅 仅在 Windows 上支持 System.Drawing.Common。

构造函数

PageSettings()	使用默认打印机初始化 PageSettings 类的新实例。
PageSettings(PrinterSettings)	使用指定打印机初始化 PageSettings 类的新实例。

属性

Bounds	获取页面的大小，并且考虑由 Landscape 属性指定的页面方向。
Color	获取或设置一个值，该值指示是否应以彩色打印该页。
HardMarginX	获取页面左侧硬页边距的 X 坐标（以百分之一英寸为单位）。
HardMarginY	获取页面上方硬页边距的 Y 坐标（以百分之一英寸为单位）。
Landscape	获取或设置一个值，该值指示是横向还是纵向打印该页。
Margins	获取或设置该页的边距。
PaperSize	获取或设置该页的纸张大小。
PaperSource	获取或设置该页的纸张来源；例如打印机的上层纸盒。
PrintableArea	获取打印机的可打印页面区域的界限。
PrinterResolution	获取或设置该页的打印机分辨率。
PrinterSettings	获取或设置与该页关联的打印机设置。

方法

Clone()	创建此 PageSettings 的副本。
CopyToHdevmode(IntPtr)	将相关信息从 PageSettings 复制到指定的 DEVMODE 结构。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
SetHdevmode(IntPtr)	将相关信息从指定的 DEVMODE 结构复制到 PageSettings。
ToString()	将 PageSettings 转换为字符串形式。

另请参阅

• PrintDocument
• PrinterSettings