SystemTrayIcon QML Type

システムトレイアイコン。もっと見る...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• available : bool
• geometry : rect (since Qt.labs.platform 1.1 (Qt 5.12))
• icon (since Qt.labs.platform 1.1 (Qt 5.12))
  • icon.mask : bool (since Qt.labs.platform 1.1 (Qt 5.12))
  • icon.name : string (since Qt.labs.platform 1.1 (Qt 5.12))
  • icon.source : url (since Qt.labs.platform 1.1 (Qt 5.12))
• menu : Menu
• supportsMessages : bool
• tooltip : string
• visible : bool

信号

• activated(ActivationReason reason)
• messageClicked()

方法

• void hide()
• void show()
• void showMessage(string title, string message, MessageIcon icon, int msecs)

詳細説明

SystemTrayIcon型は、システムトレイにあるアプリケーションのアイコンを提供します。

多くのデスクトップ・プラットフォームは、特別なシステム・トレイまたは通知領域を提供し、アプリケーションはそこにアイコンと通知メッセージを表示することができます。

次の例では、システムトレイアイコンを作成する方法と、activated() シグナルを使用する方法を示します：

SystemTrayIcon {
    visible: true
    icon.source: "qrc:/images/tray-icon.png"

    onActivated: {
        window.show()
        window.raise()
        window.requestActivate()
    }
}

トレイメニュー

SystemTrayIcon は、アイコンがアクティブになったときに開くメニューを持つことができます。

次の例は、システムトレイアイコンにMenu を割り当てる方法を示しています：

SystemTrayIcon {
    visible: true
    icon.source: "qrc:/images/tray-icon.png"

    menu: Menu {
        MenuItem {
            text: qsTr("Quit")
            onTriggered: Qt.quit()
        }
    }
}

通知メッセージ

SystemTrayIcon は、通知メッセージを表示することができます。

次の例では、showMessage （）を使用して通知メッセージを表示する方法と、messageClicked （）シグナルを利用する方法を紹介します：

SystemTrayIcon {
    visible: true
    icon.source: "qrc:/images/tray-icon.png"

    onMessageClicked: console.log("Message clicked")
    Component.onCompleted: showMessage("Message title", "Something important came up. Click this to know more.")
}

可用性

ネイティブのシステムトレイアイコンは、現在以下のプラットフォームでavailable です：

• freedesktop.org XEmbed システムトレイ仕様を実装しているすべてのウィンドウマネージャと X11 用の独立トレイ実装。
• freedesktop.org D-Bus StatusNotifierItem 仕様を実装しているすべてのデスクトップ環境 (KDE と Unity の最近のバージョンを含む)。
• サポートされているすべてのバージョンの macOS。10.8 (Mountain Lion) 以前の OS X でshowMessage() がメッセージを表示するには Growl 通知システムがインストールされていなければならないことに注意してください。

Qt Labs Platform モジュールは、ネイティブ実装が利用できないプラットフォームでのフォールバックとしてQt Widgets を使用します。したがって、Qt Labs Platform モジュールの型を使用するアプリケーションは、QtWidgets にリンクし、QGuiApplication の代わりにQApplication を使用する必要があります。

QtWidgets ライブラリにリンクするには、qmake プロジェクト・ファイルに以下を追加します：

QT += widgets

main() にQApplication のインスタンスを作成します：

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

Menuも参照して ください。

プロパティのドキュメント

available : bool [read-only]

このプロパティは、システムトレイが利用可能かどうかを保持する。

geometry : rect [since Qt.labs.platform 1.1 (Qt 5.12)]

このプロパティは、システムトレイアイコンのジオメトリを保持します。

このプロパティは Qt.labs.platform 1.1 (Qt 5.12) で導入されました。

icon group

このプロパティは、システムトレイアイコンを保持します。

SystemTrayIcon {
    icon.mask: true
    icon.source: "qrc:/images/tray-icon.png"
}

これらのプロパティはQt.labs.platform 1.1 (Qt 5.12)で導入されました。

menu : Menu

このプロパティは、システムトレイアイコンのメニューを保持する。

supportsMessages : bool [read-only]

このプロパティは、システム・トレイ・アイコンが通知メッセージをサポートしているかどうかを保持する。

showMessage()も参照してください 。

tooltip : string

このプロパティは、システムトレイアイコンのツールチップを保持する。

visible : bool

このプロパティは、システムトレイアイコンを表示するかどうかを保持する。

デフォルト値はfalse です。

シグナル・ドキュメント

activated(ActivationReason reason)

このシグナルは、ユーザによってシステムトレイアイコンがアクティブにされたときに発せられる。reason 引数は、システムトレイアイコンがどのようにアクティブになったかを指定する。

利用可能な理由

messageClicked()

このシグナルは、通知メッセージがユーザーによってクリックされたときに発せられます。

showMessage()も参照してください 。

メソッドのドキュメント

void hide()

システムトレイアイコンを隠す。

void show()

システムトレイアイコンを表示します。

void showMessage(string title, string message, MessageIcon icon, int msecs)

msecs で指定された時間、指定されたtitle 、message 、icon のシステム・トレイ・メッセージを表示する。

supportsMessages およびmessageClicked()も参照のこと 。