Поделиться через


PrintTicket.PageScalingFactor Свойство

Определение

Получает или задает процент увеличения или уменьшения размера принтера на странице.

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)

Значение свойства

Значение Int32, представляющее процент.

Исключения

Вызывающий код попытался задать свойство значением, которое меньше 1.

Комментарии

Принтер может иметь максимальные и минимальные ограничения для масштабирования. Можно протестировать ограничения масштабирования с помощью PageScalingFactorRange.

Значение null для этого свойства означает, что этот параметр компонента не указан. Кроме того, если значение null, XML-версии PrintTicket (см. SaveTo и GetXmlStream) не будут содержать разметку для этой функции.

Это свойство обычно представляет масштабирования ключевого слова схемы печати. Но есть некоторые сложности, как показано ниже.

При чтении свойства PageScalingFactor свойство ведет себя следующим образом.

  • Если xml-документ PrintTicket имеет функцию PageScaling для параметра CustomSquare, а параметр CustomSquareScale имеет положительное значение, то это возвращаемое значение.

  • Если xml-документ PrintTicket имеет параметр для параметра Custom, а параметр ScaleWid th параметра custom является положительным значением, то это возвращаемое значение.

  • Во всех остальных случаях возвращается null.

При задании свойства PageScalingFactor свойство ведет себя следующим образом.

  • Если задано значение null, то разметка PageScaling удаляется из XML-документа PrintTicket.

  • В противном случае компонент в XML-документе PrintTicket имеет значение CustomSqua re, а для параметра Scale параметра CustomSquare задано значение переданного значения. (В исключениях, что происходит, если свойству присвоено значение меньше 1.)

Применяется к