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 auf Skalierungsgrenzwerte testen, PageScalingFactorRangeindem Sie .

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

Diese PageScalingFactor Eigenschaft stellt in der Regel den MaßstabScoredProperty 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 das PrintTicket-XML-Dokument das PageScaling Feature auf die Option CustomSquare festgelegt hat und der Skalierungswert der CustomSquare-Option positiv ist, ist dies der zurückgegebene Wert.

• Wenn das PrintTicket-XML-Dokument das PageScaling Feature auf die Option "Benutzerdefiniert" festgelegt hat und der ScaleWidth-Wert der benutzerdefinierten Option positiv ist, ist dies der zurückgegebene Wert.

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

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

• Wenn sie auf null festgelegt 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 CustomSquare-Option wird auf den übergebenen Wert festgelegt. (Siehe Ausnahmen , was passiert, wenn die Eigenschaft auf einen Wert kleiner als 1 festgelegt ist.)