Qt WidgetsにおけるQSystemTrayIcon::MessageIconの詳細解説

Qt WidgetsにおけるQSystemTrayIcon::MessageIconの詳細解説

QSystemTrayIcon::MessageIcon は、システムトレイアイコンでバルーンメッセージを表示する際に使用されるアイコンの種類を表す列挙型です。

種類

以下の4つの種類があります。

• Information: 情報を表すアイコン。通常は青い円に白いiマークが表示されます。
• Warning: 警告を表すアイコン。通常は黄色い三角形に黒いビックリマークが表示されます。
• Critical: エラーを表すアイコン。通常は赤い円に白い×マークが表示されます。
• Custom: ユーザー定義のアイコン。

コード例

以下のコード例は、QSystemTrayIcon::MessageIcon を使用してバルーンメッセージを表示する方法を示します。

#include <QApplication>
#include <QSystemTrayIcon>

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  // システムトレイアイコンを作成
  QSystemTrayIcon trayIcon;

  // バルーンメッセージのタイトルと本文を設定
  trayIcon.showMessage("タイトル", "本文");

  // メッセージアイコンを設定
  trayIcon.setMessageIcon(QSystemTrayIcon::Warning);

  // バルーンメッセージを表示
  trayIcon.showBalloon();

  return app.exec();
}

詳細

• QSystemTrayIcon::MessageIcon は、QSystemTrayIcon::showMessage() メソッドで使用されます。
• QSystemTrayIcon::Custom を選択した場合、QSystemTrayIcon::setIcon() メソッドを使用して、バルーンメッセージに表示するカスタムアイコンを設定する必要があります。
• プラットフォームによっては、すべてのアイコンが利用できない場合があります。

補足

• Qt Widgets は、Qt アプリケーション開発のための C++ クラスライブラリです。
• システムトレイアイコンは、ユーザーインターフェースの邪魔にならないように、タスクバーの横に小さなアイコンを表示する機能です。
• バルーンメッセージは、システムトレイアイコンの上にポップアップするメッセージです。

• ご不明な点があれば、お気軽にご質問ください。

本ページでは、Qt WidgetsにおけるQSystemTrayIcon::MessageIconを使用したサンプルコードをいくつか紹介します。

情報アイコン付きバルーンメッセージの表示

#include <QApplication>
#include <QSystemTrayIcon>

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  // システムトレイアイコンを作成
  QSystemTrayIcon trayIcon;

  // バルーンメッセージのタイトルと本文を設定
  trayIcon.showMessage("タイトル", "本文");

  // 情報アイコンを設定
  trayIcon.setMessageIcon(QSystemTrayIcon::Information);

  // バルーンメッセージを表示
  trayIcon.showBalloon();

  return app.exec();
}

警告アイコン付きバルーンメッセージの表示

#include <QApplication>
#include <QSystemTrayIcon>

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  // システムトレイアイコンを作成
  QSystemTrayIcon trayIcon;

  // バルーンメッセージのタイトルと本文を設定
  trayIcon.showMessage("警告", "問題が発生しました！");

  // 警告アイコンを設定
  trayIcon.setMessageIcon(QSystemTrayIcon::Warning);

  // バルーンメッセージを表示
  trayIcon.showBalloon();

  return app.exec();
}

エラーアイコン付きバルーンメッセージの表示

#include <QApplication>
#include <QSystemTrayIcon>

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  // システムトレイアイコンを作成
  QSystemTrayIcon trayIcon;

  // バルーンメッセージのタイトルと本文を設定
  trayIcon.showMessage("エラー", "重大なエラーが発生しました！");

  // エラーアイコンを設定
  trayIcon.setMessageIcon(QSystemTrayIcon::Critical);

  // バルーンメッセージを表示
  trayIcon.showBalloon();

  return app.exec();
}

カスタムアイコン付きバルーンメッセージの表示

#include <QApplication>
#include <QSystemTrayIcon>
#include <QPixmap>

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  // システムトレイアイコンを作成
  QSystemTrayIcon trayIcon;

  // バルーンメッセージのタイトルと本文を設定
  trayIcon.showMessage("カスタムアイコン", "カスタムアイコンが表示されています！");

  // カスタムアイコンを設定
  QPixmap pixmap("custom_icon.png");
  trayIcon.setIcon(pixmap);
  trayIcon.setMessageIcon(QSystemTrayIcon::Custom);

  // バルーンメッセージを表示
  trayIcon.showBalloon();

  return app.exec();
}

バルーンメッセージのクリックイベント処理

#include <QApplication>
#include <QSystemTrayIcon>

int main(int argc, char *argv[]) {
  QApplication app(argc, argv);

  // システムトレイアイコンを作成
  QSystemTrayIcon trayIcon;

  // バルーンメッセージのタイトルと本文を設定
  trayIcon.showMessage("クリックイベント", "バルーンメッセージをクリックしてください！");

  // 警告アイコンを設定
  trayIcon.setMessageIcon(QSystemTrayIcon::Warning);

  // バルーンメッセージのクリックイベント処理
  QObject::connect(&trayIcon, &QSystemTrayIcon::messageClicked, []() {
    // ここにクリック時の処理を記述
    qDebug() << "バルーンメッセージがクリックされました！";
  });

  // バルーンメッセージを表示
  trayIcon.showBalloon();

  return app.exec();
}

Qt Widgetsでバルーンメッセージを表示する他の方法

方法

• QToolTip::showText()

  この方法は、ウィジェットの上にツールチップを表示する方法です。ツールチップは、マウスがウィジェット上にある間だけ表示されます。

QToolTip::showText(widget->rect().center(), "バルーンメッセージの本文");

• QWidget::setToolTip()

  この方法は、ウィジェットにツールチップを設定する方法です。ツールチップは、マウスがウィジェット上にある間だけ表示されます。

widget->setToolTip("バルーンメッセージの本文");

• QDialog

  この方法は、バルーンメッセージを表示するためのダイアログを作成する方法です。ダイアログは、ユーザーが閉じるまで表示されます。

QDialog dialog;
dialog.setWindowTitle("バルーンメッセージ");
dialog.setLayout(new QVBoxLayout);
dialog.layout()->addWidget(new QLabel("バルーンメッセージの本文"));
dialog.exec();

各方法の比較

その他の方法

• カスタムウィジェットを作成して、バルーンメッセージを表示する
• Qt 以外のライブラリを使用する