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も参照してください 。

プロパティ Documentation

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

シグナル・ドキュメント

メソッド・ドキュメント