QSystemTrayIcon Class

メンバ関数のドキュメント

QSystemTrayIcon::QSystemTrayIcon(QObject *parent = nullptr)

指定されたparent を使用して、QSystemTrayIconオブジェクトを生成します。

アイコンは初期状態では非表示です。

visibleも参照してください 。

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

指定されたicon およびparent を使用して、QSystemTrayIconオブジェクトを生成します。

アイコンは初期状態では非表示です。

visibleも参照してください 。

[virtual noexcept] QSystemTrayIcon::~QSystemTrayIcon()

システムトレイからアイコンを削除し、割り当てられていたリソースをすべて解放します。

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

このシグナルは、ユーザーがシステムトレイのアイコンをアクティブにしたときに発生します。reason は、アクティブ化の理由を指定します。QSystemTrayIcon::ActivationReason には、さまざまな理由が列挙されています。

「QSystemTrayIcon::ActivationReason」も参照してください 。

QMenu *QSystemTrayIcon::contextMenu() const

システムトレイのエントリに対する現在のコンテキストメニューを返します。

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

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

QObject::event(QEvent *e) を再実装します。

QRect QSystemTrayIcon::geometry() const

システムトレイアイコンのジオメトリを画面座標で返します。

「visible」も参照してください 。

[slot] void QSystemTrayIcon::hide()

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

show() およびvisibleも参照してください 。

[static] bool QSystemTrayIcon::isSystemTrayAvailable()

システムトレイが利用可能な場合は `true ` を返し、そうでない場合は `false` を返します。

システムトレイが現在利用できない状態であっても、後で利用可能になった場合、QSystemTrayIcon は、visible である場合に自動的にシステムトレイにエントリを追加します。

[signal] void QSystemTrayIcon::messageClicked()

このシグナルは、showMessage() を使用して表示されたメッセージがユーザーによってクリックされたときに発生します。

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

void QSystemTrayIcon::setContextMenu(QMenu *menu)

指定されたmenu を、システムトレイアイコンのコンテキストメニューとして設定します。

ユーザーがマウスボタンをクリックしてシステムトレイアイコンのコンテキストメニューを呼び出すと、このメニューが表示されます。

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

[slot] void QSystemTrayIcon::show()

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

hide() およびvisibleも参照してください 。

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

指定された `title`、`message `、および `icon ` を持つエントリについて、`millisecondsTimeoutHint` で指定された時刻にバルーンメッセージを表示します。`title ` および `message ` はプレーンテキストの文字列でなければなりません。

メッセージはユーザーがクリック可能です。クリックされると、messageClicked() シグナルが発信されます。

メッセージの表示はシステムの設定やユーザーの設定に依存しており、メッセージがまったく表示されない場合もあることに注意してください。したがって、重要な情報を提供するための唯一の手段としてこれに依存すべきではありません。

Windows では、アプリケーションにフォーカスがある場合、millisecondsTimeoutHint は通常、システムによって無視されます。

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

show() およびsupportsMessages()も参照してください 。

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

指定されたtitle 、message 、およびカスタムアイコンicon を持つエントリについて、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()

システムトレイがバルーンメッセージに対応している場合は `true ` を返し、そうでない場合は `false` を返します。

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