語言

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 和 SaveTo）的 XML 版本GetXmlStream不會包含此功能的任何標記。

此PageScalingFactor特性通常代表列印結構ScoredProperty關鍵字的縮放PageScaling。 但有一些複雜性，如下所示。

讀取該 PageScalingFactor 性質時，該性質的行為如下。

  • 如果 PrintTicket XML 文件的功能 PageScaling 集是 CustomSquare 選項，且 CustomSquare 選項的 Scale 值為正值，則回傳的值就是這個值。

  • 如果 PrintTicket XML 文件的 Custom 選項具備PageScaling功能集，且 Custom 選項的 ScaleWidth 值為正值，則回傳的值就是這個值。

  • 在其他情況下， null 會被退回。

設定屬性時 PageScalingFactor ，屬性的行為如下。

  • 如果設定為 null，則 PageScaling 標記會從 PrintTicket XML 文件中移除。

  • 否則， PageScaling PrintTicket XML 文件中的功能會設定為 CustomSquare ，而 CustomSquare 選項的 縮放 值則設為傳出的值。 （ 關於若 屬性設定為小於1的例外情況，請參見例外。）

適用於