PrintTicket.PageScalingFactor Propriété

Définition

Espace de noms:

System.Printing

Assembly:

ReachFramework.dll

Obtient ou définit le pourcentage par lequel l’imprimante agrandit ou réduit l’image d’impression sur une page.

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)

Valeur de propriété

Nullable<Int32>

Valeur Int32 qui représente un pourcentage.

Exceptions

ArgumentOutOfRangeException

L’appel de code a tenté de définir la propriété sur une valeur inférieure à 1.

Remarques

L’imprimante peut avoir des limites maximales et minimales pour la mise à l’échelle. Vous pouvez tester les limites de mise à l’échelle à l’aide de PageScalingFactorRange.

Une valeur null pour cette propriété signifie que ce paramètre de fonctionnalité n’est pas spécifié. En outre, lorsque la valeur est null, les versions XML de l'PrintTicket (voir SaveTo et GetXmlStream) ne contiennent aucun balisage pour cette fonctionnalité.

Cette propriété représente généralement le de mise à l’échelle du mot clé's 's. Mais il y a des complexités comme suit.

Lors de la lecture de la propriété PageScalingFactor, la propriété se comporte comme suit.

• Si le document XML PrintTicket a la fonctionnalité PageScaling définie sur l’option CustomSquare, et que l’option CustomSquare'option Scale est une valeur positive, c’est-à-dire la valeur retournée.

• Si le document XML PrintTicket a la fonctionnalité définie sur l’option personnalisée, et que la valeur personnalisée de l’option ScaleWidth est positive, c’est-à-dire la valeur retournée.

• Dans tous les autres cas, null est retournée.

Lorsque vous définissez la propriété PageScalingFactor, la propriété se comporte comme suit.

• S’il est défini sur null, le balisage PageScaling est supprimé du document XML PrintTicket.

• Dans le cas contraire, la fonctionnalité de du document XML PrintTicket est définie sur CustomSquare et la valeur Scale de l’option Scale de l’option CustomSquare est définie sur la valeur passée. (Voir Exceptions pour ce qui se passe si la propriété est définie sur une valeur inférieure à 1.)