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 檔已將 PageScaling 功能設定為 CustomSquare 選項，而 CustomSquare 選項的 Scale 值為正值，則會傳回該值。

• 如果 PrintTicket XML 檔 PageScaling 功能設定為 Custom 選項，而 Custom 選項的 ScaleWidth 值為正值，則為傳回的值。

• 在所有其他情況下，會傳回 null。

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

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

• 否則，PrintTicket XML 檔中的 PageScaling 功能會設定為 CustomSquare，而 customSquare 選項 Scale 值會設定為傳遞的值。 （如需屬性設定為小於 1 的值，請參閱 例外狀況。