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の目的は、プレビューを他のウィジェットに埋め込むことを可能にすることです。また、 で提供されるデフォルトのものとは異なるユーザーインターフェイスを構築することも可能です。QPrintPreviewDialog

QPrintPreviewWidgetの使い方は簡単です:

  1. QPrintPreviewWidgetの作成

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

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

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

QPrinterQPrintDialogQPageSetupDialogQPrintPreviewDialogも参照のこと

メンバー型ドキュメント

enum QPrintPreviewWidget::ViewMode

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

定数説明
QPrintPreviewWidget::SinglePageView0プレビューの単一ページを表示するモード。
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())

printerparent を親ウィジェットとしてQPrintPreviewWidgetを構築します。ウィジェットフラグflagsQWidget コンストラクタに渡されます。

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の値はビューのサイズを倍にします。

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%縮小されることを意味します。

© 2025 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.