PrintTicket.PageScalingFactor Propriedade

Definição

Espaço de Nomes:
System.Printing
Assemblagem:
ReachFramework.dll

Obtém ou define a percentagem pela qual a impressora amplia ou reduz a imagem de impressão numa 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 Propriedade

Nullable<Int32>

Um Int32 valor que representa uma percentagem.

Exceções

ArgumentOutOfRangeException

O código de chamada tentou definir a propriedade para um valor inferior a 1.

Observações

A impressora pode ter limites máximos e mínimos para escalamento. Pode testar limites de escala usando PageScalingFactorRange.

Um null valor para esta propriedade significa que esta definição de característica não é especificada. Além disso, quando o valor é null, as versões XML do PrintTicket (ver SaveTo e GetXmlStream) não conterão qualquer marcação para esta funcionalidade.

Esta PageScalingFactor propriedade representa geralmente a EscalaScoredProperty da palavra-chave do PageScaling. Mas existem algumas complexidades, como se segue.

Ao ler a PageScalingFactor propriedade, esta comporta-se da seguinte forma.

  • Se o documento XML do PrintTicket tiver a PageScaling funcionalidade definida para a opção CustomSquare, e o valor Scale da opção CustomSquare for valor positivo, então esse é o valor devolvido.

  • Se o documento XML do PrintTicket tiver a PageScaling funcionalidade definida para a opção Custom, e o valor ScaleWidth da opção Custom for valor positivo, então esse é o valor que é devolvido.

  • Em todos os outros casos, null é devolvido.

Ao definir a PageScalingFactor propriedade, esta comporta-se da seguinte forma.

  • Se estiver definido para null, então a PageScaling marcação é removida do documento XML do PrintTicket.

  • Caso contrário, a PageScaling funcionalidade no documento XML do PrintTicket é definida como CustomSquare e o valor Scale da opção CustomSquare é definido para o valor passado. ( Ver Exceções para o que acontece se a propriedade for definida para um valor inferior a 1.)

Aplica-se a