class QPdfPageRenderer

QPdfPageRenderer 类封装了 PDF 文档中页面的渲染。 更多…

摘要

属性

• document - 此对象渲染的页面实例

• renderMode - 渲染器渲染页面使用的模式

方法

• def __init__

• def document

• def renderMode

• def requestPage

• def setDocument()

• def setRenderMode()

信号

• def documentChanged()

• def pageRendered()

• def renderModeChanged()

说明

本文档可能包含从 C++ 自动翻译成 Python 的代码片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译中的问题，也可以通过在 https:/bugreports.qt.io/projects/PYSIDE 上创建工单来让我们知道。

详细描述

QPdfPageRenderer 包含一个队列，用于收集通过 requestPage() 调用的所有渲染请求。根据配置的 RenderMode，QPdfPageRenderer 将在下一事件循环调用时在主 UI 线程（RenderMode::SingleThreaded）或在单独的工作线程中（RenderMode::MultiThreaded）处理此队列，并在渲染完成后通过 pageRendered() 信号发出每个请求的结果。

另请参阅

QPdfDocument

class RenderMode

此枚举描述了页面如何渲染。

常量	描述
QPdfPageRenderer.RenderMode.MultiThreaded	所有页面都在单独的工作线程中渲染。
QPdfPageRenderer.RenderMode.SingleThreaded	所有页面都在主 UI 线程中渲染（默认）。

另请参阅

renderMode() setRenderMode()

说明

属性可以在使用 from __feature__ import true_property 时直接使用，否则通过访问器函数使用。

property documentᅟ: QPdfDocument

此属性包含从该对象渲染页面的文档实例。

默认情况下，此属性为 nullptr。

另请参阅

document() setDocument() QPdfDocument

访问函数

• document()

• setDocument()

• 信号 documentChanged()

属性 renderMode: QPdfPageRenderer.RenderMode

此属性保存渲染器渲染页面所使用的模式。

默认情况下，此属性为 RenderMode::SingleThreaded。

另请参阅

setRenderMode() RenderMode

访问函数

• renderMode()

• setRenderMode()

• 信号 renderModeChanged()

__init__()

__init__(parent)

参数:

parent - QObject

使用父对象 parent 构造页面渲染器对象。

document()

返回类型:

QPdfDocument

返回此对象渲染页面所用的文档，如果没有设置则返回 nullptr。

另请参阅

setDocument() QPdfDocument

属性 documentᅟ 的获取器。

documentChanged(document)

参数:

document - QPdfDocument

属性 documentᅟ 的通知信号。

pageRendered(pageNumber, imageSize, image, options, requestId)

参数:

• pageNumber – int

• imageSize – QSize

• image – QImage

• options – QPdfDocumentRenderOptions

• requestId – int

renderMode()

返回类型:

渲染模式

返回页面如何渲染的模式。

另请参阅

setRenderMode() RenderMode

属性 renderMode 的获取器。

renderModeChanged(renderMode)

参数:

renderMode – RenderMode

属性 renderMode 的通知信号。

requestPage(pageNumber, imageSize[, options=QPdfDocumentRenderOptions()])

参数:

• pageNumber – int

• imageSize – QSize

• options – QPdfDocumentRenderOptions

返回类型:

int

请求渲染器将页面 pageNumber 渲染为大小为 imageSize 的 QImage，并按照提供的 options 进行。

渲染完成后，会发出带有结果的参数的 pageRendered() 信号。

返回值是一个唯一标识渲染请求的 ID。如果队列中已有相同参数的请求，则返回该排队请求的 ID。

setDocument(document)

参数:

document - QPdfDocument

设置对象从其中渲染页面的文档。

另请参阅

document() QPdfDocument

属性 document 的设置器。

setRenderMode(mode)

参数:

mode – RenderMode

将页面渲染模式设置为 mode。

另请参阅

renderMode() RenderMode

属性 renderMode 的设置器。