QPrintPreviewWidget Class

成员函数文档

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

基于printer 并以parent 作为父控件，构建一个QPrintPreviewWidget。控件标志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%。