PrintTicket.PageScalingFactor Propiedad

Definición

Espacio de nombres:

System.Printing

Ensamblado:

ReachFramework.dll

Obtiene o establece el porcentaje por el que la impresora amplía o reduce la imagen de impresión en una página.

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)

Valor de propiedad

Nullable<Int32>

Valor de Int32 que representa un porcentaje.

Excepciones

ArgumentOutOfRangeException

La llamada al código ha intentado establecer la propiedad en un valor inferior a 1.

Comentarios

La impresora puede tener límites máximos y mínimos para el escalado. Puede probar los límites de escala mediante PageScalingFactorRange.

Un valor null para esta propiedad significa que no se especifica esta configuración de característica. Además, cuando el valor es null, las versiones XML del PrintTicket (vea SaveTo y GetXmlStream) no contendrán ningún marcado para esta característica.

Esta propiedad generalmente representa el Scale de la palabra clave Print Schema. Pero hay algunas complejidades como se indica a continuación.

Al leer la propiedad PageScalingFactor, la propiedad se comporta de la siguiente manera.

• Si el documento XML PrintTicket tiene la característica PageScaling establecida en la opción CustomSquare y el CustomSquare opción Scale valor es positivo, ese es el valor que se devuelve.

• Si el documento XML PrintTicket tiene la característica PageScaling establecida en la opción Custom y la opción CustomScaleWidth valor es positivo, ese es el valor devuelto.

• En todos los demás casos, se devuelve null.

Al establecer la propiedad PageScalingFactor, la propiedad se comporta de la siguiente manera.

• Si se establece en null, el marcado PageScaling se quita del documento XML PrintTicket.

• De lo contrario, la característica de en el documento XML PrintTicket se establece en customSquare y el valor de customSquare se establece en el valor pasado. (Consulte Excepciones para ver lo que sucede si la propiedad está establecida en un valor inferior a 1).