PrintTicket.PageScalingFactor Vlastnost

Definice

Obor názvů:

System.Printing

Sestavení:

ReachFramework.dll

Získá nebo nastaví procento, o které tiskárna zvětší nebo zmenší tiskový obrázek na stránce.

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)

Hodnota vlastnosti

Nullable<Int32>

Hodnota Int32, která představuje procento.

Výjimky

ArgumentOutOfRangeException

Volající kód se pokusil nastavit vlastnost na hodnotu menší než 1.

Poznámky

Tiskárna může mít maximální a minimální limity pro škálování. Omezení škálování můžete testovat pomocí PageScalingFactorRange.

Hodnota null pro tuto vlastnost znamená, že toto nastavení funkce není zadané. Pokud je hodnota null, verze XML PrintTicket (viz SaveTo a GetXmlStream) nebudou obsahovat žádné značky pro tuto funkci.

Tato vlastnost obecně představuje měřítko schématu tisku. Existuje ale několik složitostí, jak je znázorněno níže.

Při čtení vlastnosti PageScalingFactor se tato vlastnost chová následovně.

• Pokud má dokument XML printTicket nastavenou funkci PageScaling nastavenou na možnost CustomSquare a hodnota CustomSquareScale hodnota je kladná hodnota, která se vrátí.

• Pokud má dokument XML printTicket nastavenou funkci PageScaling na možnost Vlastní a hodnota VlastníScaleWid th je kladná hodnota, která se vrátí.

• Ve všech ostatních případech se vrátí null.

Při nastavování vlastnosti PageScalingFactor se tato vlastnost chová následovně.

• Pokud je nastavena na null, pak PageScaling kód je odebrán z dokumentu XML PrintTicket.

• V opačném případě je funkce PageScaling v dokumentu XML printTicket nastavena na CustomSquare a hodnota CustomSquareScale je nastavena na předanou hodnotu. (Informace o tom, co se stane, když je vlastnost nastavená na hodnotu menší než 1, najdete v tématu Výjimky.)