PrintTicket.PageScalingFactor Właściwość

Definicja

Przestrzeń nazw:

System.Printing

Zestaw:

ReachFramework.dll

Pobiera lub ustawia wartość procentową, o jaką drukarka powiększa lub zmniejsza obraz wydruku na stronie.

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)

Wartość właściwości

Nullable<Int32>

Int32 Wartość reprezentująca wartość procentową.

Wyjątki

ArgumentOutOfRangeException

Wywołanie kodu próbowało ustawić właściwość na wartość mniejszą niż 1.

Uwagi

Drukarka może mieć maksymalne i minimalne limity skalowania. Limity skalowania można przetestować przy użyciu polecenia PageScalingFactorRange.

Wartość null tej właściwości oznacza, że to ustawienie funkcji nie jest określone. Ponadto jeśli wartość to null, wersje PrintTicket XML elementu (zobacz SaveTo i GetXmlStream) nie będą zawierać żadnych znaczników dla tej funkcji.

Ta PageScalingFactor właściwość zazwyczaj reprezentuje skalęScoredProperty słowa kluczowego schematuPageScaling wydruku. Ale istnieją pewne zawiłości w następujący sposób.

Podczas odczytywania PageScalingFactor właściwości właściwość zachowuje się w następujący sposób.

• Jeśli dokument PRINTTicket XML ma funkcję ustawioną PageScaling na opcję CustomSquare, a wartość skala opcji CustomSquare jest wartością dodatnią, jest to zwracana wartość.

• Jeśli dokument PrintTicket XML ma PageScaling funkcję ustawioną na opcję Niestandardowa, a wartość ScaleWidth opcji Niestandardowe jest wartością dodatnią, jest to zwracana wartość.

• We wszystkich pozostałych przypadkach null zwracana jest wartość .

Podczas ustawiania PageScalingFactor właściwości właściwość zachowuje się w następujący sposób.

• Jeśli jest ustawiona na nullwartość , PageScaling znaczniki zostaną usunięte z dokumentu XML PrintTicket.

• PageScaling W przeciwnym razie funkcja w dokumencie XML PrintTicket jest ustawiona na wartość CustomSquare, a wartość skalowania opcji CustomSquare jest ustawiona na przekazaną wartość. (Zobacz Wyjątki dotyczące tego, co się stanie, jeśli właściwość jest ustawiona na wartość mniejszą niż 1).