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()
    }
}

트레이 메뉴

시스템 트레이 아이콘은 아이콘이 활성화될 때 열리는 메뉴를 가질 수 있습니다.

다음 예는 시스템 트레이 아이콘에 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용 모든 창 관리자 및 독립 트레이 구현.
• 최신 버전의 KDE 및 Unity를 포함하여 freedesktop.org D-Bus StatusNotifierItem 사양을 구현하는 모든 데스크톱 환경.
• 지원되는 모든 macOS 버전. OS X 10.8(Mountain Lion) 이전 버전에서 메시지를 표시하려면 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 를참조하세요 .

속성 문서

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

신호 문서

메서드 문서