PrintTicket.PageScalingFactor Właściwość

Definicja

Przestrzeń nazw:

System.Printing

Zestaw:

ReachFramework.dll

Pobiera lub ustawia wartość procentową, za pomocą której 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>

Wartość Int32 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 PageScalingFactorRange.

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

Ta właściwość zazwyczaj reprezentuje skalowania Print Schemasłowa kluczowego . Ale istnieją pewne złożoność w następujący sposób.

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

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

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

• We wszystkich innych przypadkach zwracana jest null.

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

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

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