PrintTicket.PageScalingFactor Eigenschaft

Definition

Namespace:

System.Printing

Assembly:

ReachFramework.dll

Dient zum Abrufen oder Festlegen des Prozentsatzes, um den der Drucker das Druckbild auf einer Seite vergrößert oder verkleinert.

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)

Eigenschaftswert

Nullable<Int32>

Ein Int32 Wert, der einen Prozentsatz darstellt.

Ausnahmen

ArgumentOutOfRangeException

Der Aufrufen von Code hat versucht, die Eigenschaft auf einen Wert festzulegen, der kleiner als 1 ist.

Hinweise

Der Drucker kann maximale und minimale Grenzwerte für die Skalierung aufweisen. Sie können mithilfe von PageScalingFactorRangeauf Skalierungsgrenzwerte testen.

Ein null Wert für diese Eigenschaft bedeutet, dass diese Featureeinstellung nicht angegeben ist. Wenn der Wert nullist, enthalten die XML-Versionen des PrintTicket (siehe SaveTo und GetXmlStream) kein Markup für dieses Feature.

Diese Eigenschaft stellt im Allgemeinen die Scale des schlüsselwort sPrint Schemadar. Aber es gibt einige Komplexitäten wie folgt.

Beim Lesen der PageScalingFactor-Eigenschaft verhält sich die Eigenschaft wie folgt.

• Wenn das PrintTicket-XML-Dokument die PageScaling Feature auf die Option CustomSquare festgelegt ist, und der wert der CustomSquare Option Scale wert positiv ist, ist dies der wert, der zurückgegeben wird.

• Wenn das PrintTicket-XML-Dokument das PageScaling Feature auf die Option Benutzerdefinierte festgelegt hat, und der Option option ScaleWidth wert positiv ist, ist dies der wert, der zurückgegeben wird.

• In allen anderen Fällen wird null zurückgegeben.

Beim Festlegen der PageScalingFactor-Eigenschaft verhält sich die Eigenschaft wie folgt.

• Wenn sie auf nullfestgelegt ist, wird das PageScaling Markup aus dem PrintTicket-XML-Dokument entfernt.

• Andernfalls wird das PageScaling Feature im PrintTicket-XML-Dokument auf CustomSquare- festgelegt, und der wert der CustomSquare Option Scale wird auf den übergebenen Wert festgelegt. (Siehe Ausnahmen, was geschieht, wenn die Eigenschaft auf einen Wert kleiner als 1 festgelegt ist.)