PrintTicket.PageScalingFactor Eigenschaft

Definition

Namespace:

System.Printing

Assembly:

ReachFramework.dll

Ruft den Prozentsatz ab, auf den der Drucker das gedruckte Bild auf der Seite vergrößert oder verkleinert, oder legt diesen fest.

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 eine Prozentangabe darstellt.

Ausnahmen

ArgumentOutOfRangeException

Im aufrufenden Code wurde versucht, die Eigenschaft auf einen Wert kleiner als 1 festzulegen.

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 ist null, enthalten die XML-Versionen von PrintTicket (siehe SaveTo und GetXmlStream) kein Markup für dieses Feature.

Diese PageScalingFactor Eigenschaft stellt im Allgemeinen die SkalierungScoredProperty des Schlüsselworts des DruckschemasPageScaling dar. Aber es gibt einige Komplexitäten wie folgt.

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

• Wenn für das Xml-Dokument PrintTicket das PageScaling Feature auf die Option CustomSquare festgelegt ist und der Skalierungswert der CustomSquare-Option positiv ist, ist dies der zurückgegebene Wert.

• Wenn für das Xml-Dokument PrintTicket die PageScaling Option Benutzerdefiniert festgelegt ist und der ScaleWidth-Wert der Option Benutzerdefinierter Wert positiv ist, ist dies der zurückgegebene Wert.

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

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

• Wenn es 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 Skalierungswert der Option CustomSquare wird auf den übergebenen Wert festgelegt. (Was passiert, wenn die Eigenschaft auf einen Wert kleiner als 1 festgelegt ist, finden Sie unter Ausnahmen .)