このページでは

QPrintPreviewWidget Class

QPrintPreviewWidget クラスは、プリンタ出力用のページレイアウトをプレビューするためのウィジェットを提供します。詳細...

ヘッダー: #include <QPrintPreviewWidget>
CMake: find_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmake: QT += printsupport
継承元: 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
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 の使用方法は簡単です:

  1. QPrintPreviewWidgetの生成

    既存のQPrinter オブジェクトを渡してQPrintPreviewWidgetを生成するか、QPrintPreviewWidgetにデフォルト構築されたQPrinter オブジェクトを生成させます。

  2. paintRequested() シグナルをスロットに接続します。

    ウィジェットが一連のプレビューページを生成する必要がある場合、ウィジェットからpaintRequested()シグナルが発信されます。このシグナルにスロットを接続し、シグナルのパラメータとして渡されたQPrinter に描画を行います。QPrinter::newPage()を呼び出すと、プレビュー内で新しいページが開始されます。

QPrinter 、QPrintDialog 、QPageSetupDialog 、およびQPrintPreviewDialogも参照してください 。

メンバ型のドキュメント

enum QPrintPreviewWidget::ViewMode

この列挙型は、プレビューウィジェットの表示モードを表すために使用されます。

定数値説明
QPrintPreviewWidget::SinglePageView0プレビューで 1 ページずつ表示されるモード。
QPrintPreviewWidget::FacingPagesView1プレビューで見開きページが表示されるモード。
QPrintPreviewWidget::AllPagesView2プレビュー内のすべてのページを表示する表示モード。

enum QPrintPreviewWidget::ZoomMode

この列挙型は、プレビューウィジェットのズームモードを表すために使用されます。

定数値説明
QPrintPreviewWidget::CustomZoom0ズームは、カスタムズーム値に設定されます。
QPrintPreviewWidget::FitToWidth1このモードでは、現在のページがビューの幅に合わせて表示されます。
QPrintPreviewWidget::FitInView2このモードでは、現在のページがビュー内に収まるように調整されます。

メンバ関数のドキュメント

[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.