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 and Printing APIsに含まれています。
パブリックタイプ
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の使い方は簡単です:
- QPrintPreviewWidgetの作成
既存のQPrinter オブジェクトを渡すか、QPrintPreviewWidgetにデフォルトのQPrinter オブジェクトを作成させて、QPrintPreviewWidgetを構築します。
- paintRequested()シグナルをスロットに接続します。
ウィジェットがプレビューページのセットを生成する必要がある場合、paintRequested() シグナルがウィジェットから発行されます。このシグナルにスロットを接続し、シグナルのパラメータとして渡されたQPrinter に描画します。QPrinter::newPage() を呼び出し、プレビューの新しいページを開始します。
QPrinter 、QPrintDialog 、QPageSetupDialog 、QPrintPreviewDialogも参照のこと 。
メンバー型ドキュメント
enum QPrintPreviewWidget::ViewMode
この列挙型は、プレビューウィジェットのビューモードを記述するために使用されます。
定数 | 値 | 説明 |
---|---|---|
QPrintPreviewWidget::SinglePageView | 0 | プレビューの単一ページを表示するモード。 |
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の値はビューのサイズを倍にします。
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.