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(および GetXmlStreamを参照) SaveTo の PrintTicket XML バージョンには、この機能のマークアップは含まれません。

通常、このプロパティはPageScalingFactor、印刷スキーマのキーワードの ScaleScoredProperty をPageScaling表します。 しかし、次のような複雑さがあります。

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

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

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

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

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

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

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

適用対象