QPrintPreviewWidget 类

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

头文件 #include <QPrintPreviewWidget>
CMakefind_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmakeQT += printsupport
继承 QWidget

公共类型

枚举ViewMode { SinglePageView, FacingPagesView, AllPagesView }
枚举ZoomMode { CustomZoom, FitToWidth, FitInView }

公共函数

QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
virtual~QPrintPreviewWidget()
intcurrentPage() const
QPageLayout::Orientationorientation() const
intpageCount() const
QPrintPreviewWidget::ViewModeviewMode() const
qrealzoomFactor() const
QPrintPreviewWidget::ZoomModezoomMode() const

重写的公共函数

virtual voidsetVisible(bool visible) override

公共槽

voidfitInView()
voidfitToWidth()
voidprint()
voidsetAllPagesViewMode()
voidsetCurrentPage(int page)
voidsetFacingPagesViewMode()
voidsetLandscapeOrientation()
voidsetOrientation(QPageLayout::Orientation orientation)
voidsetPortraitOrientation()
voidsetSinglePageViewMode()
voidsetViewMode(QPrintPreviewWidget::ViewMode mode)
voidsetZoomFactor(qreal factor)
voidsetZoomMode(QPrintPreviewWidget::ZoomMode zoomMode)
voidupdatePreview()
voidzoomIn(qreal factor = 1.1)
voidzoomOut(qreal factor = 1.1)

信号

voidpaintRequested(QPrinter *printer)
voidpreviewChanged()

详细描述

QPrintPreviewDialog 内部使用 QPrintPreviewWidget,QPrintPreviewWidget 的目的是能够将预览嵌入到其他小部件中。它还可以允许围绕它构建与 QPrintPreviewDialog 默认提供的不同用户界面。

使用 QPrintPreviewWidget 很简单

  1. 创建 QPrintPreviewWidget

    可以通过传入现有的 QPrinter 对象来构造 QPrintPreviewWidget,或者让 QPrintPreviewWidget 为您创建默认构造的 QPrinter 对象。

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

    当小部件需要生成一组预览页面时,将从一个小部件发出 paintRequested() 信号。将槽连接到该信号,并在作为信号参数传入的 QPrinter 上绘制。调用 QPrinter::newPage(),以在预览中开始新的一页。

另见 QPrinterQPrintDialogQPageSetupDialogQPrintPreviewDialog

成员类型文档化

枚举 QPrintPreviewWidget::ViewMode

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

常量描述
QPrintPreviewWidget::SinglePageView0查看预览中单页的模式。
QPrintPreviewWidget::FacingPagesView1查看预览中面对页面(即两页并排显示)的模式。
QPrintPreviewWidget::AllPagesView2查看预览中所有页面的模式。

枚举 QPrintPreviewWidget::ZoomMode

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

常量描述
QPrintPreviewWidget::CustomZoom0缩放设置为自定义缩放值。
QPrintPreviewWidget::FitToWidth1此模式将当前页面适配到视图宽度。
QPrintPreviewWidget::FitInView2此模式将当前页面适配到视图中。

成员函数文档化

[显式] QPrintPreviewWidget::QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

根据 printer 构造 QPrintPreviewWidget,并以 parent 作为父小部件。将小部件标志 flags 传递到 QWidget 构造函数。

另见 QWidget::setWindowFlags

[显式] QPrintPreviewWidget::QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

这是一个重载的函数。

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

[虚品-destructible] QPrintPreviewWidget::~QPrintPreviewWidget()

销毁 QPrintPreviewWidget

int QPrintPreviewWidget::currentPage() const

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

另见 setCurrentPage

[slot] void QPrintPreviewWidget::fitInView()

这是一个方便的功能,等同于调用 setZoomMode(QPrintPreviewWidget::FitInView)

[slot] void QPrintPreviewWidget::fitToWidth()

这是一个方便的功能,等同于调用 setZoomMode(QPrintPreviewWidget::FitToWidth)

QPageLayout::Orientation QPrintPreviewWidget::orientation() const

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

另请参阅setOrientation

int QPrintPreviewWidget::pageCount() const

返回预览中的页面数。

[signal] void QPrintPreviewWidget::paintRequested(QPrinter *printer)

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

[signal] void QPrintPreviewWidget::previewChanged()

当预览小部件更改一些内部状态,例如方向时,会发出此信号。

[slot] void QPrintPreviewWidget::print()

将预览打印到预览关联的打印机。

[slot] void QPrintPreviewWidget::setAllPagesViewMode()

这是一个方便的功能,等同于调用 setViewMode(QPrintPreviewWidget::AllPagesView)

[slot] void QPrintPreviewWidget::setCurrentPage(int page)

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

另请参阅currentPage

[slot] void QPrintPreviewWidget::setFacingPagesViewMode()

这是一个方便的功能,等同于调用 setViewMode(QPrintPreviewWidget::FacingPagesView)

[slot] void QPrintPreviewWidget::setLandscapeOrientation()

这是一个方便的功能,等同于调用 setOrientation(QPageLayout::Landscape)

[slot] void QPrintPreviewWidget::setOrientation(QPageLayout::Orientation orientation)

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

另请参阅orientation

[槽函数] void QPrintPreviewWidget::setPortraitOrientation()

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

[槽函数] void QPrintPreviewWidget::setSinglePageViewMode()

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

[槽函数] void QPrintPreviewWidget::setViewMode(QPrintPreviewWidget::ViewMode mode)

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

另请参阅viewMode

[重写虚函数] void QPrintPreviewWidget::setVisible(bool visible)

[槽函数] void QPrintPreviewWidget::setZoomFactor(qreal factor)

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

另请参阅zoomFactor

[槽函数] void QPrintPreviewWidget::setZoomMode(QPrintPreviewWidget::ZoomMode zoomMode)

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

另请参阅zoomModeviewMode,和 setViewMode

[槽函数] void QPrintPreviewWidget::updatePreview()

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

QPrintPreviewWidget::ViewMode QPrintPreviewWidget::viewMode() const

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

另请参阅setViewMode

qreal QPrintPreviewWidget::zoomFactor() const

返回视图的缩放因子。

另请参阅setZoomFactor

[槽函数] void QPrintPreviewWidget::zoomIn(qreal factor = 1.1)

通过 factor 缩放当前视图。默认的 factor 值为 1.1,这意味着视图将扩大 10%。

QPrintPreviewWidget::ZoomMode QPrintPreviewWidget::zoomMode() const

返回当前的缩放模式。

另请参阅 setZoomMode()、viewModesetViewMode

[槽] void QPrintPreviewWidget::zoomOut(qreal factor = 1.1)

factor 因子缩小当前视图。默认值 factor 为 1.1,意味着视图会缩小 10%。

© 2024 The Qt Company Ltd. 本文档的贡献权归各自的拥有者所有。本文档遵循由自由软件基金会发布的 GNU 自由文档许可证版本 1.3 的条款。Qt 及其相关标志是 The Qt Company Ltd. 在芬兰和其他全球国家的商标。所有其他商标归各自的拥有者所有。