PDFium Delphi Component Docs

TPdfThumbnailView Класс

Модуль: FPdfThumbnail
Прокручиваемый элемент управления, который располагает миниатюры страниц PDF вертикально или горизонтально и позволяет переходить к странице щелчком по миниатюре

Syntax

type TPdfThumbnailOrientation = (ptoVertical, ptoHorizontal);
type TPdfThumbnailView = class(TCustomControl) ... end;

Methods

MemberDescription
CreateИнициализирует размеры миниатюр, цвета, прокрутку и состояние выделения по умолчанию
DestroyОсвобождает внутренние ресурсы управления миниатюрами
EnsureCurrentPageVisibleПрокручивает окно просмотра миниатюр только когда выбранная страница (нумерация с единицы) вне видимого диапазона

Properties

PropertyTypeDefaultDescription
PdfTPdfnilКомпонент документа, используемый для подсчёта страниц и рендеринга миниатюр
CurrentPageIndexInteger0Индекс выбранной страницы, нумерация с единицы; его изменение удерживает выбранную миниатюру в поле зрения, а 0 означает отсутствие выделения
OrientationTPdfThumbnailOrientationptoVerticalВыбирает вертикальный список с полосой прокрутки справа или горизонтальную ленту с полосой прокрутки снизу
FirstVisiblePageIndexIntegerТолько чтениеПервая страница текущего окна просмотра миниатюр, нумерация с единицы, или 0, когда страница документа недоступна
LastVisiblePageIndexIntegerТолько чтениеПоследняя страница текущего окна просмотра миниатюр, нумерация с единицы, или 0, когда страница документа недоступна
ThumbnailWidthInteger120Целевая ширина миниатюры, ограниченная поддерживаемым диапазоном
ThumbnailHeightInteger160Целевая высота миниатюры, ограниченная поддерживаемым диапазоном
TextColorTColorclBlackЦвет подписи с номером страницы
HoverColorTColorclMoneyGreenЦвет подсветки строки под миниатюрой под курсором
SelectionColorTColorclHighlightЦвет подсветки строки для CurrentPageIndex
BorderColorTColorclGrayЦвет рамки миниатюры
ColorTColorclWhiteЦвет фона элемента управления, унаследованный от TCustomControl
Align, Anchors, Visible—Переопубликованные свойства TControl для стандартного размещения и видимости на форме

Events

EventTypeDescription
OnPageClickTPdfThumbnailClickEventВозбуждается, когда пользователь щёлкает левой кнопкой по строке миниатюры; APageIndex нумеруется с единицы

Description

Назначьте Pdf тот же экземпляр TPdf, что использует просмотрщик, и держите CurrentPageIndex синхронизированным с активной страницей

Используйте ptoVertical для боковой панели или ptoHorizontal для киноленты; проверка попаданий, отрисовка, прокрутка и запросы видимого диапазона следуют выбранной ориентации

Элемент управления сам ведёт прокрутку и удерживает отрисованные битмапы только для текущего видимого диапазона страниц, поэтому при соседней прокрутке перекрывающиеся страницы используются повторно, не удерживая весь документ в памяти

Назначение другого Pdf или изменение ThumbnailWidth или ThumbnailHeight очищает кэшированные битмапы, тогда как изменения состояния наведения и текущей страницы используют их повторно

Обрабатывайте OnPageClick, чтобы обновлять парный TPdfView.PageNumber или любую другую поверхность навигации по страницам

Example

ThumbnailView.Pdf := Pdf1;
ThumbnailView.Orientation := ptoHorizontal;
ThumbnailView.CurrentPageIndex := PdfView1.PageNumber;
ThumbnailView.OnPageClick := ThumbnailPageClick;

See Also

TPdfView, TPdfView.PageNumber