QPrintPreviewWidget Class

成员函数文档

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

以printer 为基础构建 QPrintPreviewWidget，并将parent 作为父 widget。部件标志flags 将传递给QWidget 构造函数。

另请参阅 QWidget::setWindowFlags().

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

这是一个重载函数。

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

[virtual noexcept] 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)

设置预览中的当前页面。这将使视图跳到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() 。

[slot] void QPrintPreviewWidget::setPortraitOrientation()

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

[slot] void QPrintPreviewWidget::setSinglePageViewMode()

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

[slot] void QPrintPreviewWidget::setViewMode(QPrintPreviewWidget::ViewMode mode)

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

另请参阅 viewMode() 。

[override virtual] void QPrintPreviewWidget::setVisible(bool visible)

[slot] void QPrintPreviewWidget::setZoomFactor(qreal factor)

将视图的缩放系数设置为factor 。例如，1.0 表示未缩放视图，与纸张上的视图大小大致相同。数值为 0.5 时，视图的大小将减半，而数值为 2.0 时，视图的大小将增加一倍。

另请参阅 zoomFactor()。

[slot] void QPrintPreviewWidget::setZoomMode(QPrintPreviewWidget::ZoomMode zoomMode)

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

另请参阅 zoomMode()、viewMode() 和setViewMode()。

[slot] void QPrintPreviewWidget::updatePreview()

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

QPrintPreviewWidget::ViewMode QPrintPreviewWidget::viewMode() const

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

另请参阅 setViewMode() 。

qreal QPrintPreviewWidget::zoomFactor() const

返回视图的缩放系数。

另请参阅 setZoomFactor()。

[slot] void QPrintPreviewWidget::zoomIn(qreal factor = 1.1)

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

QPrintPreviewWidget::ZoomMode QPrintPreviewWidget::zoomMode() const

返回当前的缩放模式。

另请参阅 setZoomMode()、viewMode() 和setViewMode()。

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

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