TCustomRichView.DocumentPixelsPerInch [VCL, LCL]

<< Нажмите, чтобы показать Содержание >>

TCustomRichView.DocumentPixelsPerInch [VCL, LCL]

Позволяет переопределять плотность пикселей для рисования документов в этом компоненте («плотность пикселей» – это количество логических пикселей в одном дюйме, также известное как значение DPI или PPI).

property DocumentPixelsPerInch: Integer;

Текущее используемое значение плотности пикселей возвращается методом GetRealDocumentPixelsPerInch.

Визуальное масштабирование

DocumentPixelsPerInch даёт возможность реализовать масштабирование. Например, если плотность пикселей экрана (или текущего монитора) равна 96 DPI, вы можете задать DocumentPixelsPerInch = 192, чтобы применить 200% масштабирование.

Это масштабирование влияет только на отображение в TRichView. Оно не влияет на печать, экспорт и импорт файлов.

После изменения значения этого свойства вызовите Format или Reformat.

Масштабирование применяется практически ко всему: полям, фоновым изображениям, элементам документа. Однако есть исключения; следующие элементы не затрагиваются:

компоненты

изображения из TImageList (значки и интерактивные значки)*

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

* в Lazarus 2+, изображения из TImageList масштабируются (выбором варианта изображения для требуемого значения DPI, или масштабированием изображения, если вариант изображения для требуемого значения DPI отсутствует в TImageList).

Примечание про Инструменты интерфейса ТРВ (RichViewActions)

Если вы используете компонент TRVRuler из Инструментов интерфейса ТРВ, после изменения значения DocumentPixelsPerInch необходимо изменить свойство Zoom:

  RVRuler1.Zoom := 

    Round(100 * 

      RichViewEdit1.GetRealDocumentPixelsPerInch / 

      RVRuler1.ScreenRes);

Если ваше приложение поддерживает мониторы с различной плотностью пикселей («per monitor v2») и вы изменили DocumentPixelsPerInch, вам необходимо пересчитать масштаб линейки в событии OnAfterMonitorDpiChanged формы.

srv_icon Примечение про СРВ-Редактор (ScaleRichView)

Между масштабированием в ТРВ-Редакторе и СРВ-Редакторе есть существенное различие.

В ТРВ-Редакторе при изменении значения DocumentPixelsPerInch документы форматируются с указанным значением DPI, обеспечивая идеальные результаты для этого конкретного значения. Однако масштабирование не является точно пропорциональным (ширина текста при DPI = 192 может быть не ровно в два раза больше ширины текста при DPI = 96).

В СРВ-Редакторе документы форматируются с высоким значением DPI, а затем рисуются на экране или принтере в пропорциональном масштабе. СРВ-Редактор может не обеспечивать идеальное позиционирование символов, но всё масштабируется пропорционально, что позволяет реализовать WYSIWYG-редактор (в котором изображение на экране и принтере отличается только масштабом).

Значение по умолчанию:

0

См. также:

TRVStyle.UnitsPixelsPerInch

ZoomPercent (аналог для FireMonkey)