QPrintPreviewWidget ¶

概要 ¶

详细描述 ¶

QPrintPreviewDialog uses a QPrintPreviewWidget internally, and the purpose of QPrintPreviewWidget is to make it possible to embed the preview into other widgets. It also makes it possible to build a different user interface around it than the default one provided with QPrintPreviewDialog .

使用 QPrintPreviewWidget is straightforward:

1. Create the QPrintPreviewWidget

   Construct the QPrintPreviewWidget either by passing in an existing QPrinter object, or have QPrintPreviewWidget create a default constructed QPrinter object for you.

2. Connect the paintRequested() signal to a slot.

   When the widget needs to generate a set of preview pages, a paintRequested() signal will be emitted from the widget. Connect a slot to this signal, and draw onto the QPrinter passed in as a signal parameter. Call newPage() , to start a new page in the preview.

另请参阅

QPrinter QPrintDialog QPageSetupDialog QPrintPreviewDialog

class QPrintPreviewWidget ( printer [ , parent=None [ , flags=Qt.WindowFlags() ] ] ) ¶

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

param parent

QWidget

param flags

WindowFlags

param printer

QPrinter

构造 QPrintPreviewWidget 基于 printer 和采用 parent as the parent widget. The widget flags flags are passed on to the QWidget 构造函数。

另请参阅

setWindowFlags()

这是重载函数。

This will cause QPrintPreviewWidget to create an internal, default constructed QPrinter object, which will be used to generate the preview.

PySide2.QtPrintSupport.QPrintPreviewWidget. ViewMode ¶

This enum is used to describe the view mode of the preview widget.

常量	描述
QPrintPreviewWidget.SinglePageView	A mode where single pages in the preview is viewed.
QPrintPreviewWidget.FacingPagesView	A mode where the facing pages in the preview is viewed.
QPrintPreviewWidget.AllPagesView	A view mode where all the pages in the preview is viewed.

PySide2.QtPrintSupport.QPrintPreviewWidget. ZoomMode ¶

This enum is used to describe zoom mode of the preview widget.

常量	描述
QPrintPreviewWidget.CustomZoom	The zoom is set to a custom zoom value.
QPrintPreviewWidget.FitToWidth	This mode fits the current page to the width of the view.
QPrintPreviewWidget.FitInView	This mode fits the current page inside the view.

PySide2.QtPrintSupport.QPrintPreviewWidget. currentPage ( ) ¶

返回类型

int

Returns the currently viewed page in the preview.

另请参阅

setCurrentPage()

PySide2.QtPrintSupport.QPrintPreviewWidget. fitInView ( ) ¶

This is a convenience function and is the same as calling setZoomMode(QPrintPreviewWidget::FitInView) .

PySide2.QtPrintSupport.QPrintPreviewWidget. fitToWidth ( ) ¶

This is a convenience function and is the same as calling setZoomMode(QPrintPreviewWidget::FitToWidth) .

PySide2.QtPrintSupport.QPrintPreviewWidget. orientation ( ) ¶

返回类型

取向

Returns the current orientation of the preview. This value is obtained from the QPrinter object associated with the preview.

另请参阅

setOrientation()

PySide2.QtPrintSupport.QPrintPreviewWidget. pageCount ( ) ¶

返回类型

int

Returns the number of pages in the preview.

PySide2.QtPrintSupport.QPrintPreviewWidget. paintRequested ( printer ) ¶

参数

printer – QPrinter

PySide2.QtPrintSupport.QPrintPreviewWidget. previewChanged ( ) ¶

PySide2.QtPrintSupport.QPrintPreviewWidget. print_ ( ) ¶

Prints the preview to the printer associated with the preview.

PySide2.QtPrintSupport.QPrintPreviewWidget. setAllPagesViewMode ( ) ¶

This is a convenience function and is the same as calling setViewMode(QPrintPreviewWidget::AllPagesView) .

PySide2.QtPrintSupport.QPrintPreviewWidget. setCurrentPage ( pageNumber ) ¶

参数

pageNumber – int

Sets the current page in the preview. This will cause the view to skip to the beginning of page .

另请参阅

currentPage()

PySide2.QtPrintSupport.QPrintPreviewWidget. setFacingPagesViewMode ( ) ¶

This is a convenience function and is the same as calling setViewMode(QPrintPreviewWidget::FacingPagesView) .

PySide2.QtPrintSupport.QPrintPreviewWidget. setLandscapeOrientation ( ) ¶

This is a convenience function and is the same as calling setOrientation(QPrinter::Landscape) .

PySide2.QtPrintSupport.QPrintPreviewWidget. setOrientation ( orientation ) ¶

参数

orientation – 取向

Sets the current orientation to orientation . This value will be set on the QPrinter object associated with the preview.

另请参阅

orientation()

PySide2.QtPrintSupport.QPrintPreviewWidget. setPortraitOrientation ( ) ¶

This is a convenience function and is the same as calling setOrientation(QPrinter::Portrait) .

PySide2.QtPrintSupport.QPrintPreviewWidget. setSinglePageViewMode ( ) ¶

This is a convenience function and is the same as calling setViewMode(QPrintPreviewWidget::SinglePageView) .

PySide2.QtPrintSupport.QPrintPreviewWidget. setViewMode ( viewMode ) ¶

参数

viewMode – ViewMode

Sets the view mode to mode . The default view mode is SinglePageView .

另请参阅

viewMode()

PySide2.QtPrintSupport.QPrintPreviewWidget. setZoomFactor ( zoomFactor ) ¶

参数

zoomFactor – qreal

Sets the zoom factor of the view to factor . For example, a value of 1.0 indicates an unscaled view, which is approximately the size the view will have on paper. A value of 0.5 will halve the size of the view, while a value of 2.0 will double the size of the view.

另请参阅

zoomFactor()

PySide2.QtPrintSupport.QPrintPreviewWidget. setZoomMode ( zoomMode ) ¶

参数

zoomMode – ZoomMode

Sets the zoom mode to zoomMode . The default zoom mode is FitInView .

另请参阅

zoomMode() viewMode() setViewMode()

PySide2.QtPrintSupport.QPrintPreviewWidget. updatePreview ( ) ¶

This function updates the preview, which causes the paintRequested() signal to be emitted.

PySide2.QtPrintSupport.QPrintPreviewWidget. viewMode ( ) ¶

返回类型

ViewMode

Returns the current view mode. The default view mode is SinglePageView .

另请参阅

setViewMode()

PySide2.QtPrintSupport.QPrintPreviewWidget. zoomFactor ( ) ¶

返回类型

qreal

Returns the zoom factor of the view.

另请参阅

setZoomFactor()

PySide2.QtPrintSupport.QPrintPreviewWidget. zoomIn ( [ zoom=1.1 ] ) ¶

参数

zoom – qreal

Zooms the current view in by factor . The default value for factor is 1.1, which means the view will be scaled up by 10%.

PySide2.QtPrintSupport.QPrintPreviewWidget. zoomMode ( ) ¶

返回类型

ZoomMode

Returns the current zoom mode.

另请参阅

setZoomMode() viewMode() setViewMode()

PySide2.QtPrintSupport.QPrintPreviewWidget. zoomOut ( [ zoom=1.1 ] ) ¶

参数

zoom – qreal

Zooms the current view out by factor . The default value for factor is 1.1, which means the view will be scaled down by 10%.