Qt WidgetsのQSystemTrayIcon::messageClicked()：サンプルコードで学ぶメッセージクリック処理

Qt WidgetsにおけるQSystemTrayIcon::messageClicked()の詳細解説

QSystemTrayIcon::messageClicked()は、システムトレイアイコン上でユーザーがメッセージをクリックした時に発生するシグナルです。このシグナルを受け取ることで、メッセージクリック時の処理を実装することができます。

シグネチャ

void messageClicked(const QString &message);

引数

• message: ユーザーがクリックしたメッセージの内容を表すQStringオブジェクト

処理内容

このシグナルスロット内で、メッセージクリック時の処理を記述します。例えば、以下の処理が考えられます。

• メッセージの内容に応じて、ダイアログボックスを表示する
• 特定のアプリケーションを起動する
• システム設定を変更する

例

void MainWindow::on_systemTrayIcon_messageClicked(const QString &message)
{
  // メッセージの内容によって処理を分岐
  if (message == "Open Settings") {
    // 設定ダイアログを表示
    SettingsDialog dialog;
    dialog.exec();
  } else if (message == "Quit") {
    // アプリケーションを終了
    qApp->quit();
  }
}

補足

• QSystemTrayIcon::showMessage()を使用して、システムトレイアイコンにメッセージを表示することができます。
• QSystemTrayIcon::setIcon()を使用して、システムトレイアイコンに表示するアイコンを設定することができます。

QSystemTrayIcon::messageClicked() 使用例

メッセージ内容に応じた処理

void MainWindow::on_systemTrayIcon_messageClicked(const QString &message)
{
  // メッセージ内容によって処理を分岐
  if (message == "Open Settings") {
    // 設定ダイアログを表示
    SettingsDialog dialog;
    dialog.exec();
  } else if (message == "Quit") {
    // アプリケーションを終了
    qApp->quit();
  } else if (message == "Show Message") {
    // 簡易メッセージボックスを表示
    QMessageBox::information(this, "Information", "メッセージクリック！");
  }
}

メッセージクリック時にカスタムウィジェットを表示

void MainWindow::on_systemTrayIcon_messageClicked(const QString &message)
{
  // クリックされたメッセージに基づいてウィジェットの内容を変更
  CustomWidget widget;
  if (message == "Show Details") {
    widget.setMessage("詳細情報が表示されます。");
  } else if (message == "Open Preferences") {
    widget.setMessage("設定画面を開きます。");
  }

  // ウィジェットを表示
  widget.show();
}

システム設定変更

void MainWindow::on_systemTrayIcon_messageClicked(const QString &message)
{
  if (message == "Toggle Mute") {
    // 音声ミュート設定の切り替え
    bool isMuted = !QSound::isMuted();
    QSound::setMuted(isMuted);

    // アイコン更新
    systemTrayIcon->setIcon(isMuted ? QIcon(":/icons/muted.png") : QIcon(":/icons/unmuted.png"));
  }
}

複数メッセージ表示

void MainWindow::on_systemTrayIcon_messageClicked(const QString &message)
{
  // メッセージ内容に基づいて処理
  if (message == "Show All Messages") {
    // すべてのメッセージを表示
    for (const QString &msg : messages) {
      systemTrayIcon->showMessage(msg, QString(), QSystemTrayIcon::Information);
    }
  } else {
    // 個別メッセージを表示
    systemTrayIcon->showMessage(message, QString(), QSystemTrayIcon::Information);
  }
}

QSystemTrayIcon::messageClicked() 以外の方法

システムトレイアイコン上で右クリックメニューを表示し、メニュー項目を選択時に処理を行う方法です。

void MainWindow::on_systemTrayIcon_activated(QSystemTrayIcon::ActivationReason reason)
{
  if (reason == QSystemTrayIcon::ActivationReason::Trigger) {
    // 右クリックメニューを表示
    QMenu menu;
    menu.addAction("Open Settings");
    menu.addAction("Quit");
    menu.exec(QCursor::pos());
  }
}

QSystemTrayIcon::contextMenu()

システムトレイアイコン上で右クリックメニューを表示し、メニュー項目を選択時に処理を行う方法です。

void MainWindow::on_systemTrayIcon_contextMenuRequested(QPoint pos)
{
  // メニュー作成
  QMenu menu;
  menu.addAction("Open Settings");
  menu.addAction("Quit");

  // メニュー表示
  menu.exec(pos);
}

QTimer::singleShot()

メッセージ表示後に一定時間後に自動的に消去する方法です。

void MainWindow::on_systemTrayIcon_messageClicked(const QString &message)
{
  systemTrayIcon->showMessage(message, QString(), QSystemTrayIcon::Information);

  // 5秒後にメッセージを消去
  QTimer::singleShot(5000, systemTrayIcon, SLOT(hideMessage()));
}

上記の方法は、QSystemTrayIcon::messageClicked() 以外にもメッセージクリック時の処理を行う方法として有効です。