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 Skalierungsbeschränkungen PageScalingFactorRangetesten.

Ein null Wert für diese Eigenschaft bedeutet, dass diese Featureeinstellung nicht angegeben wird. Auch wenn der Wert nulllautet, enthält die XML-Versionen der PrintTicket (siehe SaveTo und GetXmlStream) kein Markup für dieses Feature.

Diese PageScalingFactor Eigenschaft stellt im Allgemeinen die Skalierung ScoredProperty des Schlüsselworts "Print SchemaPageScaling" dar. Aber es gibt einige Komplexitäten wie folgt.

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

• Wenn das PrintTicket-XML-Dokument das PageScaling Feature auf die Option "CustomSquare" festgelegt hat, und der Wert der Option "CustomSquare" ist positiver Wert, dann ist das der Wert, der zurückgegeben wird.

• Wenn das PrintTicket-XML-Dokument die PageScaling Funktion auf die Option "Benutzerdefinierte Option" festgelegt hat, und der Wert "ScaleWidth" der benutzerdefinierten Option ist positiver Wert, dann ist das der Wert, der zurückgegeben wird.

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

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

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

• Andernfalls wird das Feature im PrintTicket-XML-Dokument auf CustomSquare festgelegt, und der PageScaling Skalierungswert der CustomSquare-Option wird auf den übergebenen Wert festgelegt. (Weitere Ausnahmen finden Sie unter Ausnahmen, wenn die Eigenschaft auf einen Wert festgelegt ist, der kleiner als 1 ist.)