QPdfView 类
A PDF 视图小部件。 更多...
| 头文件 | #include <QPdfView> |
| 继承 | QAbstractScrollArea |
公共类型
属性
|
|
公共函数
| QPdfView(QWidget *parent) | |
| virtual | ~QPdfView() |
| int | currentSearchResultIndex() const |
| QPdfDocument * | document() const |
| QMargins | documentMargins() const |
| QPdfView::PageMode | pageMode() const |
| QPdfPageNavigator * | pageNavigator() const |
| int | pageSpacing() const |
| QPdfSearchModel * | searchModel() const |
| void | setDocument(QPdfDocument *document) |
| void | setDocumentMargins(QMargins margins) |
| void | setPageSpacing(int spacing) |
| void | setSearchModel(QPdfSearchModel *searchModel) |
| qreal | zoomFactor() const |
| QPdfView::ZoomMode | zoomMode() const |
公共槽
| void | setCurrentSearchResultIndex(int currentResult) |
| void | setPageMode(QPdfView::PageMode mode) |
| void | setZoomFactor(qreal factor) |
| void | setZoomMode(QPdfView::ZoomMode mode) |
信号
| void | currentSearchResultIndexChanged(int currentResult) |
| void | documentChanged(QPdfDocument *document) |
| void | documentMarginsChanged(QMargins documentMargins) |
| void | pageModeChanged(QPdfView::PageMode pageMode) |
| void | pageSpacingChanged(int pageSpacing) |
| void | searchModelChanged(QPdfSearchModel *searchModel) |
| void | zoomFactorChanged(qreal zoomFactor) |
| void | zoomModeChanged(QPdfView::ZoomMode zoomMode) |
详细说明
QPdfView是一个PDF查看器小部件，提供类似于许多常见的PDF查看器应用程序的用户体验，有二种模式。在MultiPage模式中，它支持在整个文档中翻页，页面图像之间有小小的间隙。在SinglePage模式下，它一次显示一页。
成员类型说明
enum class QPdfView::PageMode
此枚举描述了PDF查看器的整体行为
| 常量 | 值 | 描述 |
|---|---|---|
QPdfView::PageMode::SinglePage | 0 | 一次显示一页。 |
QPdfView::PageMode::MultiPage | 1 | 允许滚动浏览文档中的所有页面。 |
enum class QPdfView::ZoomMode
此枚举描述了PDF查看器的放大行为
| 常量 | 值 | 描述 |
|---|---|---|
QPdfView::ZoomMode::Custom | 0 | 仅使用zoomFactor。 |
QPdfView::ZoomMode::FitToWidth | 1 | 自动选择缩放因子，使页面宽度适合视窗。 |
QPdfView::ZoomMode::FitInView | 2 | 自动选择缩放因子，使整个页面适合视窗。 |
属性说明
[since 6.6] currentSearchResultIndex : int
如果此属性设置为正数，并且searchModel已设置，QPdfView将在给定的索引处绘制一个框架来包围由QPdfSearchModel提供的搜索结果。例如，如果QPdfSearchModel用作QListView的模型，您可以通过将QItemSelectionModel::currentChanged()从QListView::selectionModel()连接到一个将转向调用此函数的函数，来保持此属性的更新。
默认值为-1，因此不会对搜索结果进行框架。
此属性在Qt 6.6中引入。
访问函数
| int | currentSearchResultIndex() const |
| void | setCurrentSearchResultIndex(int currentResult) |
通知信号
| void | currentSearchResultIndexChanged(int currentResult) |
document : QPdfDocument*
此属性包含要查看的文档。
访问函数
| QPdfDocument * | document() const |
| void | setDocument(QPdfDocument *document) |
通知信号
| void | documentChanged(QPdfDocument *document) |
documentMargins : QMargins
此属性包含页面视图周围的边距。
访问函数
| QMargins | documentMargins() const |
| void | setDocumentMargins(QMargins margins) |
通知信号
| void | documentMarginsChanged(QMargins documentMargins) |
pageMode : PageMode
该属性表示是否一次显示一页，还是显示文档中的所有页面。默认值为 SinglePage。
访问函数
| QPdfView::PageMode | pageMode() const |
| void | setPageMode(QPdfView::PageMode mode) |
通知信号
| void | pageModeChanged(QPdfView::PageMode pageMode) |
pageSpacing : int
该属性表示在《MultiPage》模式下的页面之间的填充大小。
访问函数
| int | pageSpacing() const |
| void | setPageSpacing(int spacing) |
通知信号
| void | pageSpacingChanged(int pageSpacing) |
[since 6.6] searchModel : QPdfSearchModel*
如果设置该属性，QPdfView将使用由QPdfSearchModel::resultsOnPage提供的搜索结果绘制突出矩形。默认为 nullptr。
此属性在Qt 6.6中引入。
访问函数
| QPdfSearchModel * | searchModel() const |
| void | setSearchModel(QPdfSearchModel *searchModel) |
通知信号
| void | searchModelChanged(QPdfSearchModel *searchModel) |
zoomFactor : qreal
该属性表示像素与点之间的比率。默认值为 1，表示一个点（1/72英寸）等于1逻辑像素。
访问函数
| qreal | zoomFactor() const |
| void | setZoomFactor(qreal factor) |
通知信号
| void | zoomFactorChanged(qreal zoomFactor) |
zoomMode : ZoomMode
该属性指示是否使用自定义页面尺寸，或者将其缩放到视图大小。默认值为 CustomZoom。
访问函数
| QPdfView::ZoomMode | zoomMode() const |
| void | setZoomMode(QPdfView::ZoomMode mode) |
通知信号
| void | zoomModeChanged(QPdfView::ZoomMode zoomMode) |
成员函数文档
[显式] QPdfView::QPdfView(QWidget *parent)
使用父部件 parent 构造一个 PDF 查看器。
[虚拟 noexcept] QPdfView::~QPdfView()
销毁 PDF 查看器。
QPdfPageNavigator *QPdfView::pageNavigator() const
此访问器返回将处理后退/前进导航的导航堆栈。
© 2024 Qt 公司及版权所有者。本文件中的文档贡献属于各自所有者的版权。本文件提供的文档受GNU自由文档许可证版本1.3项下许可，由自由软件基金组织发布。Qt及其相关商标属于芬兰Qt公司及其它国家/地区的公司。所有其他商标属于其各自所有者。
