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, která je menší než 1.

Poznámky

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

Hodnota null této vlastnosti znamená, že toto nastavení funkce není zadáno. Pokud je nullhodnota , verze XML objektu PrintTicket (viz SaveTo a GetXmlStream) nebudou obsahovat žádné značky pro tuto funkci.

Tato PageScalingFactor vlastnost obecně představuje měřítkoScoredProperty klíčového slova Print SchemaPageScaling. Ale existují některé složitosti, jak je uvedeno níže.

Při čtení vlastnosti se PageScalingFactor vlastnost chová následujícím způsobem.

• Pokud má dokument PRINTTicket XML funkci nastavenou PageScaling na možnost CustomSquare a hodnota Scale možnosti CustomSquare je kladná hodnota, pak je to vrácená hodnota.

• Pokud má dokument XML PrintTicket nastavenou PageScaling funkci na možnost Vlastní a hodnota ScaleWidth možnosti Custom je kladná hodnota, pak je to vrácená hodnota.

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

Při nastavování vlastnosti se PageScalingFactor vlastnost chová následujícím způsobem.

• Pokud je nastavená na nullhodnotu , odebere PageScaling se z dokumentu PRINTTicket XML kód.

• V opačném PageScaling případě je funkce v dokumentu PrintTicket XML nastavena na CustomSquare a hodnota Scale možnosti CustomSquare 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.)