En esta página

SystemTrayIcon QML Type

Un icono en la bandeja del sistema. Más...

Import Statement: import Qt.labs.platform
Inherits:

QtObject

Propiedades

Señales

Métodos

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

Descripción detallada

El tipo SystemTrayIcon proporciona un icono para una aplicación en la bandeja del sistema.

Muchas plataformas de escritorio cuentan con una bandeja del sistema o área de notificaciones especial, donde las aplicaciones pueden mostrar iconos y mensajes de notificación.

Icono de la bandeja del sistema

El siguiente ejemplo muestra cómo crear un icono de la bandeja del sistema y cómo utilizar la señal « activated()»:

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

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

Menú de la bandeja

SystemTrayIcon puede tener un menú que se abre al activar el icono.

Icono de la bandeja del sistema con menú

El siguiente ejemplo ilustra cómo asignar un ` Menu ` a un icono de la bandeja del sistema:

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

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

Mensajes de notificación

SystemTrayIcon puede mostrar mensajes de notificación.

Ventana emergente con un mensaje en el icono de la bandeja del sistema

El siguiente ejemplo muestra cómo mostrar un mensaje de notificación utilizando ` showMessage()` y cómo utilizar la señal ` 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.")
}

Disponibilidad

Actualmente, el icono nativo de la bandeja del sistema está disponible en las siguientes plataformas: available

El módulo Qt Labs Platform utiliza Qt Widgets como alternativa en plataformas que no dispongan de una implementación nativa. Por lo tanto, las aplicaciones que utilicen tipos del módulo Qt Labs Platform deben enlazar con QtWidgets y utilizar QApplication en lugar de QGuiApplication.

Para vincularse a la biblioteca QtWidgets, añade lo siguiente a tu archivo de proyecto qmake:

QT += widgets

Crea una instancia de QApplication en main():

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

Nota: No se garantiza que los tipos de los módulos de Qt.labs sigan siendo compatibles en futuras versiones.

Véase también Menu.

Documentación de propiedades

available : bool [read-only]

Esta propiedad se mantiene independientemente de si la bandeja del sistema está disponible.

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

Esta propiedad contiene la geometría del icono de la bandeja del sistema.

Esta propiedad se introdujo en Qt Labs Platform 1.1 (Qt 5.12).

icon group

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)]

Esta propiedad contiene el icono de la bandeja del sistema.

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

Estas propiedades se introdujeron en Qt Labs Platform 1.1 (Qt 5.12).

Esta propiedad contiene un menú para el icono de la bandeja del sistema.

supportsMessages : bool [read-only]

Esta propiedad indica si el icono de la bandeja del sistema admite mensajes de notificación.

Véase también showMessage().

tooltip : string

Esta propiedad contiene la descripción emergente del icono de la bandeja del sistema.

visible : bool

Esta propiedad indica si el icono de la bandeja del sistema está visible.

El valor por defecto es « false ».

Documentación de Signal

activated(ActivationReason reason)

Esta señal se emite cuando el usuario activa el icono de la bandeja del sistema. El argumento « reason » especifica cómo se activó el icono de la bandeja del sistema.

Motivos disponibles:

ConstanteDescripción
SystemTrayIcon.UnknownMotivo desconocido
SystemTrayIcon.ContextSe ha solicitado el menú contextual del icono de la bandeja del sistema
SystemTrayIcon.DoubleClickSe ha hecho doble clic en el icono de la bandeja del sistema
SystemTrayIcon.TriggerSe ha hecho clic en el icono de la bandeja del sistema
SystemTrayIcon.MiddleClickSe ha hecho clic en el icono de la bandeja del sistema con el botón central del ratón

Nota: El controlador correspondiente es onActivated.

messageClicked()

Esta señal se emite cuando el usuario hace clic en un mensaje de notificación.

Nota: El controlador correspondiente es onMessageClicked.

Véase también showMessage().

Documentación del método

void hide()

Oculta el icono de la bandeja del sistema.

void show()

Muestra el icono de la bandeja del sistema.

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

Muestra un mensaje en la bandeja del sistema con los valores indicados en « title », « message » y « icon » durante el tiempo especificado en « msecs ».

Nota: Los mensajes de la bandejadel sistema dependen de la configuración del sistema y de las preferencias del usuario, y es posible que no aparezcan en absoluto. Por lo tanto, no se debe confiar en ellos como único medio para proporcionar información crítica.

Véase también supportsMessages y messageClicked().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.