QPrintPreviewWidget 类

QPrintPreviewWidget 类提供为打印机输出而预览页面布局的 Widget。更多...

头：	#include <QPrintPreviewWidget>
CMake:	find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmake:	QT += printsupport
继承：	QWidget

所有成员列表，包括继承成员
QPrintPreviewWidget is part of 打印机和打印 API .

公共类型

enum	ViewMode { SinglePageView, FacingPagesView, AllPagesView }
enum	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 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 .

Using QPrintPreviewWidget is straightforward:

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.
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 QPrinter::newPage (), to start a new page in the preview.

另请参阅 QPrinter , QPrintDialog , QPageSetupDialog ，和 QPrintPreviewDialog .

成员类型文档编制

enum QPrintPreviewWidget:: ViewMode

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

常量	值	描述
`QPrintPreviewWidget::SinglePageView`	`0`	A mode where single pages in the preview is viewed.
`QPrintPreviewWidget::FacingPagesView`	`1`	A mode where the facing pages in the preview is viewed.
`QPrintPreviewWidget::AllPagesView`	`2`	A view mode where all the pages in the preview is viewed.

enum QPrintPreviewWidget:: ZoomMode

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

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

成员函数文档编制

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

Constructs a QPrintPreviewWidget based on printer 和采用 parent as the parent widget. The widget flags flags 被传递给 QWidget 构造函数。

另请参阅 QWidget::setWindowFlags ().

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

这是重载函数。

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

`[虚拟]` QPrintPreviewWidget:: ~QPrintPreviewWidget ()

销毁 QPrintPreviewWidget .

int QPrintPreviewWidget:: currentPage () const

Returns the currently viewed page in the preview.

另请参阅 setCurrentPage ().

`[slot]` void QPrintPreviewWidget:: fitInView ()

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

`[slot]` void QPrintPreviewWidget:: fitToWidth ()

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

QPageLayout::Orientation QPrintPreviewWidget:: orientation () const

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

另请参阅 setOrientation ().

int QPrintPreviewWidget:: pageCount () const

Returns the number of pages in the preview.

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

This signal is emitted when the preview widget needs to generate a set of preview pages. printer is the printer associated with this preview widget.

`[signal]` void QPrintPreviewWidget:: previewChanged ()

This signal is emitted whenever the preview widget has changed some internal state, such as the orientation.

`[slot]` void QPrintPreviewWidget:: print ()

Prints the preview to the printer associated with the preview.

`[slot]` void QPrintPreviewWidget:: setAllPagesViewMode ()

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

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

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

另请参阅 currentPage ().

`[slot]` void QPrintPreviewWidget:: setFacingPagesViewMode ()

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

`[slot]` void QPrintPreviewWidget:: setLandscapeOrientation ()

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

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

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

另请参阅 orientation ().

`[slot]` void QPrintPreviewWidget:: setPortraitOrientation ()

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

`[slot]` void QPrintPreviewWidget:: setSinglePageViewMode ()

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

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

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

另请参阅 viewMode ().

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

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

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 ().

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

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

另请参阅 zoomMode (), viewMode ()，和 setViewMode ().

`[slot]` void QPrintPreviewWidget:: updatePreview ()

This function updates the preview, which causes the paintRequested () 信号发射。

QPrintPreviewWidget::ViewMode QPrintPreviewWidget:: viewMode () const

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

另请参阅 setViewMode ().

qreal QPrintPreviewWidget:: zoomFactor () const

Returns the zoom factor of the view.

另请参阅 setZoomFactor ().

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

Zooms the current view in by factor 。默认值对于 factor is 1.1, which means the view will be scaled up by 10%.

QPrintPreviewWidget::ZoomMode QPrintPreviewWidget:: zoomMode () const

Returns the current zoom mode.

另请参阅 setZoomMode (), viewMode ()，和 setViewMode ().

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

Zooms the current view out by factor 。默认值对于 factor is 1.1, which means the view will be scaled down by 10%.

QPrintPreviewWidget 类

公共类型

公共函数

重实现公共函数

公共槽

信号

详细描述

成员类型文档编制

enum QPrintPreviewWidget:: ViewMode

enum QPrintPreviewWidget:: ZoomMode

成员函数文档编制

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

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

[虚拟] QPrintPreviewWidget:: ~QPrintPreviewWidget ()

int QPrintPreviewWidget:: currentPage () const

[slot] void QPrintPreviewWidget:: fitInView ()

[slot] void QPrintPreviewWidget:: fitToWidth ()

QPageLayout::Orientation QPrintPreviewWidget:: orientation () const

int QPrintPreviewWidget:: pageCount () const

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

[signal] void QPrintPreviewWidget:: previewChanged ()

[slot] void QPrintPreviewWidget:: print ()

[slot] void QPrintPreviewWidget:: setAllPagesViewMode ()

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

[slot] void QPrintPreviewWidget:: setFacingPagesViewMode ()

[slot] void QPrintPreviewWidget:: setLandscapeOrientation ()

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

[slot] void QPrintPreviewWidget:: setPortraitOrientation ()

[slot] void QPrintPreviewWidget:: setSinglePageViewMode ()

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

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

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

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

[slot] void QPrintPreviewWidget:: updatePreview ()