PySide6.QtPrintSupport.QPrintPreviewWidget¶

class QPrintPreviewWidget¶

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

概要¶

方法¶

• def __init__()

• def currentPage()

• def orientation()

• def pageCount()

• def viewMode()

• def zoomFactor()

• def zoomMode()

插槽¶

• def fitInView()

• def fitToWidth()

• def print_()

• def setAllPagesViewMode()

• def setCurrentPage()

• def setFacingPagesViewMode()

• def setLandscapeOrientation()

• def setOrientation()

• def setPortraitOrientation()

• def setSinglePageViewMode()

• def setViewMode()

• def setZoomFactor()

• def setZoomMode()

• def updatePreview()

• def zoomIn()

• def zoomOut()

信号¶

• def paintRequested()

• def previewChanged()

注意

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

详细描述¶

QPrintPreviewDialog 内部使用了一个 QPrintPreviewWidget，而 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()]])¶

Parameters:

• parent – QWidget

• flags – WindowType 的组合

这是一个重载函数。

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

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

Parameters:

• 打印机 – QPrinter

• parent – QWidget

• flags – WindowType 的组合

基于printer构造一个QPrintPreviewWidget，并将parent作为父部件。部件标志flags被传递给QWidget构造函数。

另请参阅

setWindowFlags()

currentPage()¶

Return type:

整数

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

另请参阅

setCurrentPage()

fitInView()¶

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

fitToWidth()¶

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

orientation()¶

Return type:

方向

返回预览的当前方向。此值是从与预览关联的QPrinter对象中获取的。

另请参阅

setOrientation()

pageCount()¶

Return type:

整数

返回预览中的页数。

paintRequested(printer)¶

Parameters:

打印机 – QPrinter

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

previewChanged()¶

每当预览小部件更改某些内部状态（例如方向）时，都会发出此信号。

print_()¶

setAllPagesViewMode()¶

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

setCurrentPage(pageNumber)¶

Parameters:

pageNumber – int

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

另请参阅

currentPage()

setFacingPagesViewMode()¶

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

setLandscapeOrientation()¶

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

setOrientation(orientation)¶

Parameters:

方向 – Orientation

将当前方向设置为orientation。此值将设置在与预览关联的QPrinter对象上。

另请参阅

orientation()

setPortraitOrientation()¶

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

setSinglePageViewMode()¶

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

setViewMode(viewMode)¶

Parameters:

viewMode – ViewMode

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

另请参阅

viewMode()

setZoomFactor(zoomFactor)¶

Parameters:

zoomFactor – 浮点数

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

另请参阅

zoomFactor()

setZoomMode(zoomMode)¶

Parameters:

zoomMode – ZoomMode

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

另请参阅

zoomMode() viewMode() setViewMode()

updatePreview()¶

此函数更新预览，导致发出paintRequested()信号。

viewMode()¶

Return type:

ViewMode

返回当前的视图模式。默认的视图模式是 SinglePageView 。

另请参阅

setViewMode()

zoomFactor()¶

Return type:

浮点数

返回视图的缩放因子。

另请参阅

setZoomFactor()

zoomIn([zoom=1.1])¶

Parameters:

zoom – 浮点数

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

zoomMode()¶

Return type:

ZoomMode

返回当前的缩放模式。

另请参阅

setZoomMode() viewMode() setViewMode()

zoomOut([zoom=1.1])¶

Parameters:

zoom – 浮点数

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