PrintTicket.PageScalingFactor 属性

定义

命名空间:

System.Printing

程序集:

ReachFramework.dll

获取或设置打印机放大或减少页面上打印图像的百分比。

public:
 property Nullable<int> PageScalingFactor { Nullable<int> get(); void set(Nullable<int> value); };

public int? PageScalingFactor { get; set; }

member this.PageScalingFactor : Nullable<int> with get, set

Public Property PageScalingFactor As Nullable(Of Integer)

属性值

Nullable<Int32>

表示百分比的 Int32 值。

例外

ArgumentOutOfRangeException

调用代码尝试将属性设置为小于 1 的值。

注解

打印机可以具有缩放的最大和最小限制。 可以使用 PageScalingFactorRange来测试规模限制。

此属性的 null 值表示未指定此功能设置。 此外，当值 null时，PrintTicket 的 XML 版本（见 SaveTo 和 GetXmlStream）将不包含此功能的任何标记。

此 PageScalingFactor 属性通常表示 打印架构PageScaling 关键字的 缩放ScoredProperty。 但有一些复杂性，如下所示。

读取 PageScalingFactor 属性时，该属性的行为如下所示。

• 如果 PrintTicket XML 文档的 功能设置为 customSquare 选项 ，并且 customSquare 选项的 Scale 值为正值，则返回该值。

• 如果 PrintTicket XML 文档的 PageScaling 功能设置为“自定义”选项，并且 自定义 选项的 ScaleWidth 值为正值，则返回该值。

• 在所有其他情况下，将返回 null。

设置 PageScalingFactor 属性时，该属性的行为如下所示。

• 如果设置为 null，则会从 PrintTicket XML 文档中删除 PageScaling 标记。

• 否则，PrintTicket XML 文档中的 PageScaling 功能设置为 CustomSquare，CustomSquare 选项的 Scale 值设置为传递的值。 （请参阅 异常 当属性设置为小于 1 的值时会发生什么情况。