QPrintPreviewWidget Class
QPrintPreviewWidget クラスは、プリンタ出力用のページレイアウトをプレビューするためのウィジェットを提供します。詳細...
| ヘッダー: | #include <QPrintPreviewWidget> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
| 継承元: | QWidget |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QPrintPreviewWidget は、Printer および Printing 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 内部で QPrintPreviewWidget を使用しており、QPrintPreviewWidget の目的は、プレビューを他のウィジェットに埋め込むことを可能にすることです。また、QPrintPreviewDialog で提供されるデフォルトのユーザーインターフェースとは異なるインターフェースを、その周りに構築することも可能にします。
QPrintPreviewWidget の使用方法は簡単です:
- QPrintPreviewWidgetの生成
既存のQPrinter オブジェクトを渡してQPrintPreviewWidgetを生成するか、QPrintPreviewWidgetにデフォルト構築されたQPrinter オブジェクトを生成させます。
- paintRequested() シグナルをスロットに接続します。
ウィジェットが一連のプレビューページを生成する必要がある場合、ウィジェットからpaintRequested()シグナルが発信されます。このシグナルにスロットを接続し、シグナルのパラメータとして渡されたQPrinter に描画を行います。QPrinter::newPage()を呼び出すと、プレビュー内で新しいページが開始されます。
QPrinter 、QPrintDialog 、QPageSetupDialog 、およびQPrintPreviewDialogも参照してください 。
メンバ型のドキュメント
enum QPrintPreviewWidget::ViewMode
この列挙型は、プレビューウィジェットの表示モードを表すために使用されます。
| 定数 | 値 | 説明 |
|---|---|---|
QPrintPreviewWidget::SinglePageView | 0 | プレビューで 1 ページずつ表示されるモード。 |
QPrintPreviewWidget::FacingPagesView | 1 | プレビューで見開きページが表示されるモード。 |
QPrintPreviewWidget::AllPagesView | 2 | プレビュー内のすべてのページを表示する表示モード。 |
enum QPrintPreviewWidget::ZoomMode
この列挙型は、プレビューウィジェットのズームモードを表すために使用されます。
| 定数 | 値 | 説明 |
|---|---|---|
QPrintPreviewWidget::CustomZoom | 0 | ズームは、カスタムズーム値に設定されます。 |
QPrintPreviewWidget::FitToWidth | 1 | このモードでは、現在のページがビューの幅に合わせて表示されます。 |
QPrintPreviewWidget::FitInView | 2 | このモードでは、現在のページがビュー内に収まるように調整されます。 |
メンバ関数のドキュメント
[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の場合はビューのサイズが2倍になります。
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%縮小されることを意味します。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.