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 valor Int32 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 valor null para essa propriedade significa que essa configuração de recurso não está especificada. Além disso, quando o valor é null, as versões XML do PrintTicket (consulte SaveTo e GetXmlStream) não conterão nenhuma marcação para esse recurso.

Essa propriedade geralmente representa o de Escala da palavra-chave doesquema de impressão . Mas há algumas complexidades da seguinte maneira.

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

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

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

• Em todos os outros casos, null é retornado.

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

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

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