PrintTicket.PageScalingFactor プロパティ

定義

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

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 未満の値に設定されている場合の動作については、例外 を参照してください)。

適用対象