PrintTicket.PageScalingFactor Propriedade

Definição

Namespace:

System.Printing

Assembly:

ReachFramework.dll

Obtém ou define o percentual pelo qual a impressora aumenta ou reduz a imagem de impressão 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 Int32 valor que representa uma porcentagem.

Exceções

ArgumentOutOfRangeException

O código de chamada tentou definir a propriedade como 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 (ver SaveTo e GetXmlStream) não conterão nenhuma marcação para esse recurso.

Essa PageScalingFactor propriedade geralmente representa a escalaScoredProperty da palavra-chave do esquema de PageScalingimpressã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 é definido como CustomSquare e o valor de Escala da opção CustomSquare é definido como o valor passado. (Consulte Exceções para saber o que acontece se a propriedade estiver definida como um valor menor que 1.)