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 、この機能設定が指定されていないことを意味します。 また、値が指定されている場合、 nullXML バージョンの PrintTicket (see SaveTo and GetXmlStream) には、この機能のマークアップは含まれません。

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

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

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

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

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

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

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

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

適用対象