QPdfDocument 类

成员函数文档

[显式] QPdfDocument::QPdfDocument(QObject *parent)

使用父对象 parent 构建新的文档。

[覆盖虚函数 noexcept] QPdfDocument::~QPdfDocument()

销毁文档。

void QPdfDocument::close()

关闭文档。

QPdfDocument::Error QPdfDocument::error() const

如果 status 是 Error，则返回错误类型，如果没有错误则返回 NoError。

[可调用] QPdfSelection QPdfDocument::getAllText(int page)

返回给定 page 上的所有文本及其边界。

[可调用] QPdfSelection QPdfDocument::getSelection(int page, QPointF start, QPointF end)

如果有的话，返回有关给定 page 上在给定 start 和 end 点之间可以找到的文本的信息。

[可调用] QPdfSelection QPdfDocument::getSelectionAtIndex(int page, int startIndex, int maxLength)

返回给定页面（从给定 startIndex 开始，最多包含 maxLength 个字符）上文本的信息。

QPdfDocument::Error QPdfDocument::load(const QString &fileName)

从 fileName 加载数据内容。

void QPdfDocument::load(QIODevice *device)

从 device 加载数据内容。

QVariant QPdfDocument::metaData(QPdfDocument::MetaDataField field) const

返回给定 field 的文档元数据。

[可调用, 自 6.6 版起] int QPdfDocument::pageIndexForLabel(const QString &label)

返回包含 label 的页面的索引，如果没有找到则返回 -1。

此函数自 Qt 6.6 版本开始引入。

另请参阅pageLabel。

[可调用] QString QPdfDocument::pageLabel(int page)

返回用于显示目的的 page 编号。

例如，一个文档可能有多个不同的编号部分。或许前言使用罗马数字，正文从第1页开始，附录从 A1 开始。当 PDF 阅读器显示页面编号时，为了避免混淆用户，应使用与打印在页面角落上的“数字”相同的“数字”，而不是我们在 API 中使用的基于零的页面索引（假设文档作者已经使页面标签与打印数字相匹配）。

如果文档没有自定义页面编号，此函数返回 page + 1。

另请参阅pageIndexForLabel。

[可调用] QSizeF QPdfDocument::pagePointSize(int page) const

以点为单位（1/72 英寸）返回 page 页的大小。

QImage QPdfDocument::render(int page, QSize imageSize, QPdfDocumentRenderOptions renderOptions = QPdfDocumentRenderOptions())

根据提供的 renderOptions 将 page 在大小为 imageSize 的 QImage 中进行渲染。

返回渲染的页面或在出错时返回空图像。

注意：如果 imageSize 与 PDF 文档中页面宽高比不匹配，页面将按比例缩放，以确保它覆盖完整的 imageSize。