QPrintPreviewWidget Class

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

Header: #include <QPrintPreviewWidget>
CMake: find_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmake: QT += printsupport
Inherits: 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% 縮小されることを意味します。

本書に含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。