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é

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 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 schéma d’impressionPageScaling. Mais il existe quelques complexités comme suit.

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

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

  • Si la fonctionnalité du document XML PrintTicket est PageScaling définie sur l’option Personnalisé et que la valeur ScaleWidth de l’option Custom 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é dans le document XML PrintTicket est définie sur CustomSquare et la valeur De mise à l’échelle de l’option CustomSquare est définie sur la valeur passée. (Voir Exceptions pour savoir ce qui se passe si la propriété est définie sur une valeur inférieure à 1.)

S’applique à