PrintTicket.PageScalingFactor Propriedade

  • Referência

Definição

Namespace:
System.Printing
Assembly:
ReachFramework.dll

Obtém ou define o percentual pelo qual a impressora amplia ou reduz a imagem impressa em uma 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 da propriedade

Nullable<Int32>

Um valor Int32 que representa um percentual.

Exceções

ArgumentOutOfRangeException

O código de chamada tentou definir a propriedade com um valor menor que 1.

Comentários

A impressora pode ter limites máximos e mínimos para dimensionamento. Você pode testar os limites de escala usando PageScalingFactorRange.

Um null valor para essa propriedade significa que essa configuração de recurso não está especificada. Além disso, quando o valor for null, as versões XML do PrintTicket (consulte SaveTo e GetXmlStream) não conterão nenhuma marcação para esse recurso.

Essa PageScalingFactor propriedade geralmente representa a escalaScoredProperty do palavra-chave do PageScalingesquema de impressão. Mas há algumas complexidades da seguinte maneira.

Ao ler a PageScalingFactor propriedade, a propriedade se comporta da seguinte maneira.

  • Se o documento XML PrintTicket tiver o PageScaling recurso definido como a opção CustomSquare e o valor de Escala da opção CustomSquare for positivo, esse será o valor retornado.

  • Se o documento XML PrintTicket tiver o PageScaling recurso definido como a opção Personalizado e o valor ScaleWidth da opção Personalizada for positivo, esse será o valor retornado.

  • Em todos os outros casos, null é retornado.

Ao definir a PageScalingFactor propriedade, a propriedade se comporta da seguinte maneira.

  • Se estiver definido como null, a PageScaling marcação será removida do documento XML PrintTicket.

  • Caso contrário, o PageScaling recurso no documento XML PrintTicket será definido como CustomSquare e o valor de Escala da opção CustomSquare será definido como o valor passado. (Consulte Exceções para saber o que acontece se a propriedade estiver definida como um valor menor que 1.)

Aplica-se a