QPrintPreviewWidget 类
QPrintPreviewWidget 类提供了一个用于预览打印机输出的页面布局的部件。 更多信息...
头文件 | #include <QPrintPreviewWidget> |
CMake | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
qmake | QT += printsupport |
继承 | QWidget |
- 所有成员的列表,包括继承成员
- QPrintPreviewWidget 是 打印机和打印 API 的一部分。
公共类型
枚举 | 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() |
int | currentPage() const |
QPageLayout::Orientation | orientation() const |
int | pageCount() const |
QPrintPreviewWidget::ViewMode | viewMode() const |
qreal | zoomFactor() const |
QPrintPreviewWidget::ZoomMode | zoomMode() const |
重写的公共函数
virtual void | setVisible(bool visible) override |
公共槽
void | fitInView() |
void | fitToWidth() |
void | print() |
void | setAllPagesViewMode() |
void | setCurrentPage(int page) |
void | setFacingPagesViewMode() |
void | setLandscapeOrientation() |
void | setOrientation(QPageLayout::Orientation orientation) |
void | setPortraitOrientation() |
void | setSinglePageViewMode() |
void | setViewMode(QPrintPreviewWidget::ViewMode mode) |
void | setZoomFactor(qreal factor) |
void | setZoomMode(QPrintPreviewWidget::ZoomMode zoomMode) |
void | updatePreview() |
void | zoomIn(qreal factor = 1.1) |
void | zoomOut(qreal factor = 1.1) |
信号
void | paintRequested(QPrinter *printer) |
void | previewChanged() |
详细描述
QPrintPreviewDialog 内部使用 QPrintPreviewWidget,QPrintPreviewWidget 的目的是能够将预览嵌入到其他小部件中。它还可以允许围绕它构建与 QPrintPreviewDialog 默认提供的不同用户界面。
使用 QPrintPreviewWidget 很简单
- 创建 QPrintPreviewWidget
可以通过传入现有的 QPrinter 对象来构造 QPrintPreviewWidget,或者让 QPrintPreviewWidget 为您创建默认构造的 QPrinter 对象。
- 将 paintRequested() 信号连接到一个槽。
当小部件需要生成一组预览页面时,将从一个小部件发出 paintRequested() 信号。将槽连接到该信号,并在作为信号参数传入的 QPrinter 上绘制。调用 QPrinter::newPage(),以在预览中开始新的一页。
另见 QPrinter,QPrintDialog,QPageSetupDialog 和 QPrintPreviewDialog。
成员类型文档化
枚举 QPrintPreviewWidget::ViewMode
此枚举用于描述预览小部件的查看模式。
常量 | 值 | 描述 |
---|---|---|
QPrintPreviewWidget::SinglePageView | 0 | 查看预览中单页的模式。 |
QPrintPreviewWidget::FacingPagesView | 1 | 查看预览中面对页面(即两页并排显示)的模式。 |
QPrintPreviewWidget::AllPagesView | 2 | 查看预览中所有页面的模式。 |
枚举 QPrintPreviewWidget::ZoomMode
此枚举用于描述预览小部件的缩放模式。
常量 | 值 | 描述 |
---|---|---|
QPrintPreviewWidget::CustomZoom | 0 | 缩放设置为自定义缩放值。 |
QPrintPreviewWidget::FitToWidth | 1 | 此模式将当前页面适配到视图宽度。 |
QPrintPreviewWidget::FitInView | 2 | 此模式将当前页面适配到视图中。 |
成员函数文档化
[显式]
QPrintPreviewWidget::QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
根据 printer 构造 QPrintPreviewWidget,并以 parent 作为父小部件。将小部件标志 flags 传递到 QWidget 构造函数。
[显式]
QPrintPreviewWidget::QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
这是一个重载的函数。
这将导致 QPrintPreviewWidget 创建一个内部,默认构造的 QPrinter 对象,该对象将用于生成预览。
[虚品-destructible]
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。
另请参阅zoomMode,viewMode,和 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()、viewMode 和 setViewMode。
[槽]
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. 在芬兰和其他全球国家的商标。所有其他商标归各自的拥有者所有。