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 |
- 継承メンバを含む全メンバ一覧
- 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% 縮小されることを意味します。
本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。