PrintTicket.PageScalingFactor プロパティ

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

プリンターがページ上の印刷イメージを拡大または縮小する割合を取得または設定します。

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)

パーセンテージを表す Int32 値。

呼び出し元のコードは、プロパティを 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 未満の値に設定されている場合の動作については、例外を参照してください)。