QSystemTrayIcon Class

Documentación de funciones miembro

QSystemTrayIcon::QSystemTrayIcon(QObject *parent = nullptr)

Construye un objeto QSystemTrayIcon con la dirección parent.

El icono es inicialmente invisible.

Véase también visible.

QSystemTrayIcon::QSystemTrayIcon(const QIcon &icon, QObject *parent = nullptr)

Construye un objeto QSystemTrayIcon con los datos icon y parent.

El icono es inicialmente invisible.

Véase también visible.

[virtual noexcept] QSystemTrayIcon::~QSystemTrayIcon()

Elimina el icono de la bandeja del sistema y libera todos los recursos asignados.

[signal] void QSystemTrayIcon::activated(QSystemTrayIcon::ActivationReason reason)

Esta señal se emite cuando el usuario activa el icono de la bandeja del sistema. reason especifica el motivo de la activación. QSystemTrayIcon::ActivationReason enumera los distintos motivos.

Véase también QSystemTrayIcon::ActivationReason.

QMenu *QSystemTrayIcon::contextMenu() const

Devuelve el menú contextual actual para la entrada de la bandeja del sistema.

Véase también setContextMenu().

[override virtual protected] bool QSystemTrayIcon::event(QEvent *e)

Reimplementa: QObject::event(QEvent *e).

QRect QSystemTrayIcon::geometry() const

Devuelve la geometría del icono de la bandeja del sistema en coordenadas de pantalla.

Véase también visible.

[slot] void QSystemTrayIcon::hide()

Oculta la entrada de la bandeja del sistema.

Véase también show() y visible.

[static] bool QSystemTrayIcon::isSystemTrayAvailable()

Devuelve true si la bandeja del sistema está disponible; en caso contrario, devuelve false.

Si la bandeja del sistema no está disponible en ese momento pero vuelve a estarlo más tarde, QSystemTrayIcon añadirá automáticamente una entrada en la bandeja del sistema si es visible.

[signal] void QSystemTrayIcon::messageClicked()

Esta señal se emite cuando el usuario hace clic en el mensaje mostrado mediante showMessage().

Véase también activated().

void QSystemTrayIcon::setContextMenu(QMenu *menu)

Establece la dirección menu especificada como menú contextual para el icono de la bandeja del sistema.

El menú aparecerá cuando el usuario solicite el menú contextual del icono de la bandeja del sistema pulsando el botón del ratón.

Véase también contextMenu().

[slot] void QSystemTrayIcon::show()

Muestra el icono en la bandeja del sistema.

Véase también hide() y visible.

[slot] void QSystemTrayIcon::showMessage(const QString &title, const QString &message, QSystemTrayIcon::MessageIcon icon = QSystemTrayIcon::Information, int millisecondsTimeoutHint = 10000)

Muestra un mensaje de globo para la entrada con los datos title, message y icon durante el tiempo especificado en millisecondsTimeoutHint. title y message deben ser cadenas de texto sin formato.

El usuario puede hacer clic en el mensaje; la señal messageClicked() se emitirá cuando esto ocurra.

Tenga en cuenta que la visualización de los mensajes depende de la configuración del sistema y de las preferencias del usuario, y que es posible que los mensajes no aparezcan en absoluto. Por lo tanto, no debe confiarse en él como único medio para proporcionar información crítica.

En Windows, el sistema suele ignorar millisecondsTimeoutHint cuando la aplicación tiene el foco.

Se ha convertido en una ranura en Qt 5.2.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        systemTrayIcon, qOverload(&QSystemTrayIcon::showMessage));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        systemTrayIcon, [receiver = systemTrayIcon](const QString &title, const QString &message, QSystemTrayIcon::MessageIcon icon, int millisecondsTimeoutHint) { receiver->showMessage(title, message, icon, millisecondsTimeoutHint); });

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

[slot] void QSystemTrayIcon::showMessage(const QString &title, const QString &message, const QIcon &icon, int millisecondsTimeoutHint = 10000)

Muestra un mensaje de globo para la entrada con los datos title, message, y el icono personalizado icon para la hora especificada en millisecondsTimeoutHint.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        systemTrayIcon, qOverload(&QSystemTrayIcon::showMessage));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        systemTrayIcon, [receiver = systemTrayIcon](const QString &title, const QString &message, const QIcon &icon, int millisecondsTimeoutHint) { receiver->showMessage(title, message, icon, millisecondsTimeoutHint); });

[static] bool QSystemTrayIcon::supportsMessages()

Devuelve true si la bandeja del sistema admite mensajes de globo; en caso contrario devuelve false.

Véase también showMessage().