The QPrintPreviewWidget class provides a widget for previewing page layouts for printer output. 更多...
| 头： | #include <QPrintPreviewWidget> |
| qmake: | QT += printsupport |
| Since: | Qt 4.4 |
| 继承： | QWidget |
| 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 |
| QPrinter::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 (QPrinter::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 () |
| const QMetaObject | staticMetaObject |
The QPrintPreviewWidget class provides a widget for previewing page layouts for printer output.
QPrintPreviewDialog 使用 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:
Construct the QPrintPreviewWidget either by passing in an existing QPrinter object, or have QPrintPreviewWidget create a default constructed QPrinter object for you.
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 .
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. |
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. |
构造 QPrintPreviewWidget 基于 printer 和采用 parent as the parent widget. The widget flags flags 被传递给 QWidget 构造函数。
另请参阅 QWidget::setWindowFlags ().
这是重载函数。
This will cause QPrintPreviewWidget to create an internal, default constructed QPrinter object, which will be used to generate the preview.
[虚拟]
QPrintPreviewWidget::
~QPrintPreviewWidget
()
销毁 QPrintPreviewWidget .
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)
.
Returns the current orientation of the preview. This value is obtained from the QPrinter object associated with the preview.
另请参阅 setOrientation ().
Returns the number of pages in the preview.
该函数在 Qt 4.6 引入。
[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(QPrinter::Landscape)
.
[slot]
void
QPrintPreviewWidget::
setOrientation
(
QPrinter::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(QPrinter::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
)
重实现自 QWidget::setVisible ().
[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 () 信号发射。
Returns the current view mode. The default view mode is SinglePageView .
另请参阅 setViewMode ().
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%.
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%.