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 プロパティは、通常、印刷スキーマ's PageScaling キーワードの スケールScoredProperty を表します。 しかし、次のような複雑さがあります。

PageScalingFactor プロパティを読み取ると、プロパティは次のように動作します。

• PrintTicket XML ドキュメントに PageScaling 機能が CustomSquare オプションに設定されていて、CustomSquare オプションの Scale 値が正の値である場合、それが返される値です。

• PrintTicket XML ドキュメントの PageScaling 機能が Custom オプションに設定されていて、Custom オプションの ScaleWidth 値が正の値である場合、それが返される値です。

• それ以外の場合は、null が返されます。

PageScalingFactor プロパティを設定すると、プロパティは次のように動作します。

• nullに設定されている場合、PageScaling マークアップは PrintTicket XML ドキュメントから削除されます。

• それ以外の場合、PrintTicket XML ドキュメントの 機能は CustomSquare に設定され、CustomSquare オプションの Scale 値は渡された値に設定されます。 (プロパティが 1 未満の値に設定されている場合の動作については、例外 を参照してください)。