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

Le code appelant a essayé de définir la propriété à une valeur qui est 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 null valeur 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 ( PrintTicket voir SaveTo et GetXmlStream) ne contiennent aucun balisage pour cette fonctionnalité.

Cette PageScalingFactor propriété représente généralement l’échelleScoredProperty du mot clé du PageScalingschéma d’impression. Mais il existe certaines complexités comme suit.

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

• Si le document PrintTicket XML a la PageScaling fonctionnalité définie sur l’option CustomSquare et que la valeur d’échelle de l’option CustomSquare est positive, il s’agit de la valeur retournée.

• Si le document PrintTicket XML a la PageScaling fonctionnalité définie sur l’option Personnalisé et que la valeur ScaleWidth de l’option personnalisée est une valeur positive, il s’agit de la valeur retournée.

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

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

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

• Sinon, la PageScaling fonctionnalité du document PrintTicket XML est définie sur CustomSquare et la valeur de mise à l’échelle de l’option CustomSquare est définie sur la valeur transmise. (Voir Exceptions pour savoir ce qui se passe si la propriété est définie sur une valeur inférieure à 1.)