type TPdfThumbnailOrientation = (ptoVertical, ptoHorizontal);
type TPdfThumbnailView = class(TCustomControl) ... end;
| Member | Description |
|---|---|
Create | 初始化默认的缩略图尺寸、颜色、滚动和选择状态 |
Destroy | 释放缩略图控件的内部资源 |
EnsureCurrentPageVisible | 仅当选中的从 1 开始计数的页面位于可见范围之外时才滚动缩略图视口 |
| Property | Type | Default | Description |
|---|---|---|---|
Pdf | TPdf | nil | 用于页面计数和缩略图渲染的文档组件 |
CurrentPageIndex | Integer | 0 | 从 1 开始计数的选中页索引；更改它会使选中的缩略图保持可见，0 表示没有选中项 |
Orientation | TPdfThumbnailOrientation | ptoVertical | 选择带右侧滚动条的垂直列表或带底部滚动条的水平条带 |
FirstVisiblePageIndex | Integer | 只读 | 当前缩略图视口中从 1 开始计数的第一页，没有可用文档页时为 0 |
LastVisiblePageIndex | Integer | 只读 | 当前缩略图视口中从 1 开始计数的最后一页，没有可用文档页时为 0 |
ThumbnailWidth | Integer | 120 | 目标缩略图宽度，会被限制到支持的范围内 |
ThumbnailHeight | Integer | 160 | 目标缩略图高度，会被限制到支持的范围内 |
TextColor | TColor | clBlack | 页码标题的颜色 |
HoverColor | TColor | clMoneyGreen | 悬停缩略图所在行的高亮颜色 |
SelectionColor | TColor | clHighlight | CurrentPageIndex 所在行的高亮颜色 |
BorderColor | TColor | clGray | 缩略图边框颜色 |
Color | TColor | clWhite | 从 TCustomControl 继承的控件背景色 |
Align, Anchors, Visible | — | 为标准窗体布局和可见性重新发布的 TControl 属性 |
| Event | Type | Description |
|---|---|---|
OnPageClick | TPdfThumbnailClickEvent | 用户左键点击缩略图行时触发；APageIndex 从 1 开始计数 |
把 Pdf 指向与查看器相同的 TPdf 实例，然后让 CurrentPageIndex 与活动页面保持同步
侧边栏使用 ptoVertical，胶片条使用 ptoHorizontal，命中测试、绘制、滚动和可见范围查询都遵循选定的方向
控件自行管理滚动，只为当前可见页面范围保留已渲染的位图，因此在相邻滚动期间会重用重叠页面，而不会在内存中长期保留整个文档
指定另一个 Pdf 或更改 ThumbnailWidth、ThumbnailHeight 会清除缓存的位图，而悬停和当前页状态变化则会重用它们
处理 OnPageClick 以更新配对的 TPdfView.PageNumber 或任何其他页面导航界面
ThumbnailView.Pdf := Pdf1;
ThumbnailView.Orientation := ptoHorizontal;
ThumbnailView.CurrentPageIndex := PdfView1.PageNumber;
ThumbnailView.OnPageClick := ThumbnailPageClick;