class QPrintPreviewWidget#

该 QPrintPreviewWidget 类提供了一个小部件，用于预览打印机输出的页面布局。 更多…

Inheritance diagram of PySide6.QtPrintSupport.QPrintPreviewWidget

摘要#

方法#

槽函数#

信号#

注意

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

详细说明#

QPrintPreviewDialog 内部使用一个 QPrintPreviewWidget，其目的是使其能够将其嵌入到其他小部件中。它还使得围绕它构建的用户界面与 QPrintPreviewDialog 默认提供的不同。

使用 QPrintPreviewWidget 相对直接

  1. 创建 QPrintPreviewWidget

    通过传递一个现有的 QPrinter 对象来构建 QPrintPreviewWidget，或者让 QPrintPreviewWidget 为您创建一个默认构造的 QPrinter 对象。

  2. 将 paintRequested() 信号连接到槽。

    当小部件需要生成一组预览页面时，将从一个小部件发出一个 paintRequested() 信号。连接一个槽到这个信号，并绘制传递给信号的 QPrinter。调用 newPage() 以在预览中开始新的一页。

另请参阅

QPrinter QPrintDialog QPageSetupDialog QPrintPreviewDialog

class ViewMode#

此枚举用于描述预览小部件的视图模式。

常量

说明

QPrintPreviewWidget.SinglePageView

一种视图模式，它可以在预览中查看单页。

QPrintPreviewWidget.FacingPagesView

一种视图模式，可以在预览中查看前后页。

QPrintPreviewWidget.AllPagesView

一种视图模式，可以在预览中查看所有页面。
class ZoomMode#

此枚举用于描述预览小部件的缩放模式。

常量

说明

QPrintPreviewWidget.CustomZoom

缩放设置为自定义缩放值。

QPrintPreviewWidget.FitToWidth

此模式可以使当前页面适应视图宽度。

QPrintPreviewWidget.FitInView

此模式可以将当前页面适应到视图中。
__init__([parent=None[, flags=Qt.WindowFlags()]])#
参数：

这是一个重载函数。

这将导致QPrintPreviewWidget创建一个内部、默认构造的QPrinter对象，该对象将用于生成预览。

__init__(printer[, parent=None[, flags=Qt.WindowFlags()]])
参数：

基于printer构建QPrintPreviewWidget，将parent作为父窗口小部件。将窗口标志flags传递给QWidget构造函数。

另请参阅

setWindowFlags()

currentPage()#
返回类型：

int

返回预览中当前查看的页面。

另请参阅

setCurrentPage()

fitInView()#

这是一个便利函数，与调用 setZoomMode(QPrintPreviewWidget::FitInView) 相同。

fitToWidth()#

这是一个便利函数，与调用 setZoomMode(QPrintPreviewWidget::FitToWidth) 相同。

orientation()#
返回类型：

方向

返回预览的当前方向。此值来自与预览关联的 QPrinter 对象。

另请参阅

setOrientation()

pageCount()#
返回类型：

int

返回预览中的页数。

paintRequested(printer)#
参数：

printer – QPrinter

当预览小部件需要生成一组预览页时，将发出此信号。printer 是与此预览小部件关联的打印机。

previewChanged()#

当预览小部件改变某些内部状态（如方向）时，将发出此信号。

print_()#
setAllPagesViewMode()#

这是一个便利函数，与调用 setViewMode(QPrintPreviewWidget::AllPagesView) 相同。

setCurrentPage(pageNumber)#
参数：

pageNumber – int

设置预览中的当前页。这将导致视图跳转到 page 的开头。

另请参阅

currentPage()

setFacingPagesViewMode()#

这是一个便利函数，与调用 setViewMode(QPrintPreviewWidget::FacingPagesView) 相同。

setLandscapeOrientation()#

这是一个便利函数，与调用 setOrientation(QPageLayout::Landscape) 相同。

setOrientation(orientation)#
参数：

方向 – Orientation

设置当前方向为direction。此值将被设置在预览相关的QPrinter对象上。

另请参阅

direction()

setLandscapeOrientation()#

这是一个方便的函数，等同于调用setOrientation(QPageLayout::Landscape)。

setSinglePageViewMode()#

这是一个方便的函数，等同于调用setViewMode(QPrintPreviewWidget::SinglePageView)。

setViewMode(viewMode)#
参数：

视图模式 – ViewMode

将视图模式设置为mode。默认视图模式为SinglePageView。

另请参阅

viewMode()

setZoomFactor(zoomFactor)#
参数：

缩放因子 – float

将视图的缩放因子设置为factor。例如，1.0的值表示未缩放的视图，这大约是视图在纸上的大小。0.5的值将视图大小减半，而2.0的值将视图大小加倍。

另请参阅

zoomFactor()

setZoomMode(zoomMode)#
参数：

缩放模式 – ZoomMode

将缩放模式设置为zoomMode。默认缩放模式为FitInView。

updatePreview()#

此函数更新预览窗口，这会触发paintRequested()信号。

viewMode()#
返回类型：

查看模式

返回当前查看模式。默认查看模式是SinglePageView。

另请参阅

setViewMode()

zoomFactor()#
返回类型：

float

返回视图的缩放因子。

另请参阅

setZoomFactor()

zoomIn([zoom=1.1])#
参数：

zoom – float

通过倍数放大当前的视图。默认值factor为1.1，意味着视图将放大10%。

zoomMode()#
返回类型：

缩放模式

返回当前缩放模式。

zoomOut([zoom=1.1])#
参数：

zoom – float

通过倍数缩小当前的视图。默认值factor为1.1，意味着视图将缩小10%。