PrintTicket.PageScalingFactor Propriété

Définition

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

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 maximale et minimale 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' échelle ScoredProperty du mot clé du schéma d’impression PageScaling . Toutefois, 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 XML PrintTicket a la PageScaling fonctionnalité définie sur l’option CustomSquare et que la valeur d' échelle de l’option CustomSquare est une valeur positive, il s’agit de la valeur retournée.

  • Si le document XML PrintTicket a la PageScaling fonctionnalité définie sur l’option personnalisée 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.

  • Si la valeur est null , le PageScaling balisage est supprimé du document XML PrintTicket.

  • Dans le cas contraire, la PageScaling fonctionnalité du document XML PrintTicket est définie sur CustomSquare et la valeur d' échelle de l’option CustomSquare est définie sur la valeur transmise. (Consultez exceptions pour ce qui se passe si la propriété est définie sur une valeur inférieure à 1.)

S’applique à