📢 Webサイト閉鎖と移転のお知らせ
このWebサイトは2026年9月に閉鎖いたします。
新しい記事は移転先で追加しております。(旧サイトでは記事を追加しておりません)

 
(同じ利用者による、間の5版が非表示)
284行目: 284行目:


== 印刷ダイアログ ==
== 印刷ダイアログ ==
==== QPrintDialogクラス ====
印刷ダイアログにおいて、使用する場合は以下のヘッダファイルをインクルードする必要がある。<br>
#include <QtPrintSupport>
<br>
また、プロジェクトファイル(.proファイル)に、以下のモジュールを追記する必要がある。<br>
QT += core gui printsupport
<br>
下表に示すように、印刷ダイアログには、様々な支援クラスがある。<br>
<br>
印刷ダイアログを使用する場合は、描画デバイスが必要である。<br>
ページ設定等は、印刷ダイアログに組み込まれている。<br>
<center>
印刷関連クラス<br>
{| class="wikitable" style="background-color:#fefefe;"
|-
! style="background-color:#00ffff;" | クラス名
! style="background-color:#00ffff;" | 説明
|-
| QAbstractPrintDialog || 印刷ダイアログの抽象クラス
|-
| QPageSetupDialog || ページ設定
|-
| QPrintDialog || 印刷ダイアログ
|-
| QPrintEngine || 印刷サブシステムとのインターフェース定義
|-
| QPrintPreviewDialog || 印刷出力レイアウトのプレビューダイアログ
|-
| QPrintPreviewWidget || 印刷プレビューウィジェット
|-
| QPrinter || プリンタに出力する描画デバイス
|-
| QPrinterInfo || 既存プリンタの情報
|}
</center>
<br>
==== テキスト印刷 ====
文字の印刷は、QTextDocumentを使用すると簡単にできる。<br>
<br>
QTextEditクラス等は、QTextDocumentを取得できるので、テキストをセットする手間が省ける。<br>
<syntaxhighlight lang="c++">
QPrinter printer(QPrinter::HighResolution);
QPrintDialog dialog(&printer, this);
if(dialog.exec() == QDialog::Accepted)
{
    QTextDocument doc;
    doc.setPlainText("テキスト印刷のサンプルです。\n改行しました。");
    doc.print(&printer);
}
</syntaxhighlight>
<br>
==== 画像印刷 ====
以下の例では、画像ファイル(image.jpgファイル)の縦横比を崩さずに、できるだけ大きなサイズで印刷している。<br>
# 印刷領域の横と縦から、縦横比を崩さずに画像が収まるサイズを求める。
# 求めたサイズで、印刷領域の横と縦を変更する。
# 描画領域を画像サイズにして画像を描けば、自動的にサイズ調整と印刷領域への転送が行われる。
:* <code>setViewport</code>メソッドを使用して、印刷領域のサイズを変更しない場合、縦横比が崩れる。
:* <code>setWindow</code>メソッドを使用して、描画領域のサイズを変更しない場合、小さな画像になる。
<syntaxhighlight lang="c++">
QPrinter printer(QPrinter::ScreenResolution);
QPrintDialog dialog(&printer, this);
if(dialog.exec() == QDialog::Accepted)
{
    QPainter painter(&printer);
    QRect rect = painter.viewport();
    QPixmap pixmap("~/tmp/image.jpg");
    QSize size = pixmap.size();
    size.scale(rect.size(), Qt::KeepAspectRatio);
    painter.setViewport(rect.x(), rect.y(), size.width(), size.height());
    painter.setWindow(pixmap.rect());
    painter.drawPixmap(0, 0, pixmap);
}
</syntaxhighlight>
<br>
==== ウィジェット印刷 ====
以下の例では、縦横比を崩さずに、横200pxでwidgetを印刷している。<br>
# <code>widget</code>クラスの<code>grab</code>メソッドを使用して、<code>QPixmap</code>クラスを生成する。(widgetの子要素も含まれる)
# 生成した<code>QPixmap</code>クラスの横を200pxにして描画する。縦は横に合わせて自動的に伸縮される。
<syntaxhighlight lang="c++">
QPrinter printer(QPrinter::ScreenResolution);
QPrintDialog dialog(&printer, this);
if(dialog.exec() == QDialog::Accepted)
{
    QPixmap pixmap = widget->grab();
    QPainter painter(&printer);
    painter.drawPixmap(0, 0, pixmap.scaledToWidth(200));
}
</syntaxhighlight>
<br>
==== 印刷プレビュー ====
以下の例では、用紙にA4縦を指定して印刷プレビューを表示している。<br>
実際の描画は、<code>redrawPreview</code>メソッド(ユーザ定義メソッド)で行う。<br>
<br>
用紙のサイズと向きは、プレビュー画面で設定できるため、省略可能である。<br>
プレビュー画面のサイズを指定しないと、とても小さな表示になるので注意すること。<br>
<br>
設定変更による描画要求シグナルには、<code>redrawPreview</code>メソッド(ユーザ定義メソッド)を接続する。<br>
<code>exec</code>メソッドを使用して、印刷プレビュー画面を表示する。(プレビュー画面を閉じるまで制御は戻らない)<br>
<syntaxhighlight lang="c++">
// mainwindow.cpp
QPrinter printer(QPrinter::HighResolution);
printer.setPaperSize(QPrinter::A4);
printer.setOrientation(QPrinter::Portrait);
QPrintPreviewDialog preview(&printer, this);
preview.setFixedSize(this->width() - 100, this->height());


connect(&preview, SIGNAL(paintRequested(QPrinter*)), this, SLOT(redrawPreview(QPrinter*)));
preview.exec();
</syntaxhighlight>
<br>
描画関数<code>redrawPreview</code>メソッド(ユーザ定義メソッド)は、ヘッダファイルのスロットで宣言する。<br>
<syntaxhighlight lang="c++">
// mainwindow.h
private slots:
    void redrawPreview(QPrinter *printer);
</syntaxhighlight>
<br>
以下の例では、メイン画面のハードコピーを印刷プレビューに表示している。<br>
用紙全体がプレビュー画面に収まるように、自動的に縮小表示される。<br>
[ページ設定]画面の用紙の向きを変更する場合、自動的に伸縮率が変化する。<br>
<br>
QPixmapクラスの生成以外は、画像印刷と同じ処理となる。<br>
<syntaxhighlight lang="c++">
void MainWindow::redrawPreview(QPrinter *p)
{
    QPainter painter(p);
    QRect rect = painter.viewport();
    QPixmap pixmap = this->grab();
    QSize size = pixmap.size();
    size.scale(rect.size(), Qt::KeepAspectRatio);
    painter.setViewport(rect.x(), rect.y(), size.width(), size.height());
    painter.setWindow(pixmap.rect());
    painter.drawPixmap(0, 0, pixmap);
}
</syntaxhighlight>
<br>
==== 画像の印刷解像度(dpi)を設定する ====
画像ファイルで見かける解像度は、印刷解像度である。<br>
すなわち、dpiとは紙上1インチに表現する画素数の値のことである。<br>
<br>
例えば、1440[px] x 1440[px]、72[dpi]の画像を印刷する場合、紙上のサイズは、1440[px] / 72[dpi] = 20[inch] = 508[mm]となる。<br>
<br>
以下の例では、上記の値を<code>QImage</code>クラスに設定して保存している。<br>
<syntaxhighlight lang="c++">
// ドット / メートルに変換(72dpiの場合)
int dpm = 72 / 0.0254;
// 水平方向と垂直方向を別個に指定できる
qimg.setDotsPerMeterX(dpm);
qimg.setDotsPerMeterY(dpm);
 
// dpiをファイル内に保持できるフォーマットのみ保存できる
qimg.save(arrPath, "JPEG", -1);
</syntaxhighlight>
<br><br>
<br><br>


378行目: 541行目:
     ModelessDlg->show();
     ModelessDlg->show();
  }
  }
</syntaxhighlight>
<br>
モードレスダイアログ等を常に前面に表示する場合は、以下のように記述する。<br>
<syntaxhighlight lang="c++">
ModelessDlg = std::make_unique<ModelessDialog>(this);
ModelessDlg->setWindowFlags(Qt::WindowStaysOnTopHint);
ModelessDlg->show();
  </syntaxhighlight>
  </syntaxhighlight>
<br><br>
<br><br>
736行目: 908行目:
   
   
  MsgBox.exec();
  MsgBox.exec();
</syntaxhighlight>
<br><br>
== ステータスバー ==
ウインドウまたはダイアログにおいて、ステータスバーを表示する。<br>
<syntaxhighlight lang="c++">
#include <QStatusBar>
QStatusBar StatusBar;
StatusBar->showMessage(tr("ステータスを表示中..."));
</syntaxhighlight>
<br>
ステータスバーにプログレスバーを表示する場合、以下のように記述する。<br>
<syntaxhighlight lang="c++">
#include <QStatusBar>
QStatusBar StatusBar;
QProgressBar bar;
StatusBar->addWidget(&bar);
bar.setMinimum(0);
bar.setMaximum(100);
for(int i = 0; i < 100; i++)
{
    bar.setValue(i);
    // 以下に処理を記述
    // ...
}
StatusBar->removeWidget(&bar);
  </syntaxhighlight>
  </syntaxhighlight>
<br><br>
<br><br>