QSystemTrayIcon Class Reference · PyQt4 中文文檔

# QSystemTrayIcon Class Reference ## [[QtGui](index.htm) module] 該QSystemTrayIcon類提供了在系統托盤中的應用程序的圖標。[More...](#details) 繼承[QObject](qobject.html)。 ### Types * `enum ActivationReason { Unknown, Context, DoubleClick, Trigger, MiddleClick }` * `enum MessageIcon { NoIcon, Information, Warning, Critical }` ### Methods * `__init__ (self, QObject?parent?=?None)` * `__init__ (self, QIcon?icon, QObject?parent?=?None)` * `QMenu contextMenu (self)` * `bool event (self, QEvent?event)` * `QRect geometry (self)` * `hide (self)` * `QIcon icon (self)` * `bool isVisible (self)` * `setContextMenu (self, QMenu?menu)` * `setIcon (self, QIcon?icon)` * `setToolTip (self, QString?tip)` * `setVisible (self, bool?visible)` * `show (self)` * `showMessage (self, QString?title, QString?msg, MessageIcon?icon?=?QSystemTrayIcon.Information, int?msecs?=?10000)` * `QString toolTip (self)` ### Static Methods * `bool isSystemTrayAvailable ()` * `bool supportsMessages ()` ### Qt Signals * `void activated (QSystemTrayIcon::ActivationReason)` * `void messageClicked ()` * * * ## Detailed Description 該QSystemTrayIcon類提供了在系統托盤中的應用程序的圖標。現代操作系統通常提供的特殊區域在桌面上，稱為_system tray_ or _notification area_，其中長期運行的應用程序可以顯示圖標和短消息。 ![The system tray on Windows XP.](https://img.kancloud.cn/b0/ab/b0aba5ef9b43323ff114cffa5898021c_320x149.png) 該QSystemTrayIcon類可以在以下平臺上使用： * All supported versions of Windows. * All window managers for X11 that implement the [freedesktop.org](http://www.freedesktop.org/) system tray specification, including recent versions of KDE and GNOME. * All supported versions of Mac OS X. Note that the Growl notification system must be installed for [QSystemTrayIcon.showMessage](qsystemtrayicon.html#showMessage)() to display messages. 要檢查系統托盤是否存在在用戶的桌面上，調用[QSystemTrayIcon.isSystemTrayAvailable](qsystemtrayicon.html#isSystemTrayAvailable)（）靜態函數。要添加一個系統托盤項，創建一個QSystemTrayIcon對象，調用[setContextMenu](qsystemtrayicon.html#setContextMenu)（）提供的圖標的上下文菜單，并調用[show](qsystemtrayicon.html#show)（），使其在系統托盤中可見。狀態通知郵件（ “氣球消息” ）可以被使用在任何時間顯示[showMessage](qsystemtrayicon.html#showMessage)（）。如果系統托盤不可用時，系統托盤圖標的構造，但后來變為可用， QSystemTrayIcon會自動在系統托盤中的應用程序添加一個條目，如果圖標[visible](qsystemtrayicon.html#visible-prop)。該[activated](qsystemtrayicon.html#activated)當用戶激活的圖標（）信號被發射。只有在X11上，在工具提示的要求， QSystemTrayIcon收到[QHelpEvent](qhelpevent.html)類型[QEvent.ToolTip](qevent.html#Type-enum)。此外， QSystemTrayIcon接收型滾輪事件[QEvent.Wheel](qevent.html#Type-enum)。這些不支持在任何其他平臺。 * * * ## Type Documentation ``` QSystemTrayIcon.ActivationReason ``` 這個枚舉變量描述系統托盤被激活的原因。 | Constant | Value | Description | | --- | --- | --- | | `QSystemTrayIcon.Unknown` | `0` | 不明原因 | | `QSystemTrayIcon.Context` | `1` | 要求系統托盤項中的上下文菜單 | | `QSystemTrayIcon.DoubleClick` | `2` | 系統托盤條目被雙擊時 | | `QSystemTrayIcon.Trigger` | `3` | 系統托盤項被點擊 | | `QSystemTrayIcon.MiddleClick` | `4` | 系統托盤項與單擊鼠標中鍵 | **See also** [activated](qsystemtrayicon.html#activated)（）。 ``` QSystemTrayIcon.MessageIcon ``` 這個枚舉描述顯示氣球消息時所顯示的圖標。 | Constant | Value | Description | | --- | --- | --- | | `QSystemTrayIcon.NoIcon` | `0` | 顯示圖標。 | | `QSystemTrayIcon.Information` | `1` | 顯示信息圖標。 | | `QSystemTrayIcon.Warning` | `2` | 顯示一個標準的警告圖標。 | | `QSystemTrayIcon.Critical` | `3` | 顯示的嚴重警告圖標。 | **See also** [QMessageBox](qmessagebox.html)。 * * * ## Method Documentation ``` QSystemTrayIcon.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QSystemTrayIcon](qsystemtrayicon.html)與給定對象_parent_。該圖標是最初不可見的。 **See also** [visible](qsystemtrayicon.html#visible-prop)。 ``` QSystemTrayIcon.__init__ (self, QIcon?icon, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QSystemTrayIcon](qsystemtrayicon.html)與給定對象_icon_和_parent_。該圖標是最初不可見的。 **See also** [visible](qsystemtrayicon.html#visible-prop)。 ``` QMenu QSystemTrayIcon.contextMenu (self) ``` [ 返回系統托盤項中的當前上下文菜單。 ](qmenu.html) [**See also**](qmenu.html) [setContextMenu](qsystemtrayicon.html#setContextMenu)（）。 ``` bool QSystemTrayIcon.event (self, QEvent?event) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` QRect QSystemTrayIcon.geometry (self) ``` [ 返回屏幕坐標系統托盤圖標的幾何形狀。此功能被引入Qt的4.3 。 ](qrect.html) [**See also**](qrect.html) [visible](qsystemtrayicon.html#visible-prop)。 ``` QSystemTrayIcon.hide (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void hide()`。隱藏系統托盤項。 **See also** [show](qsystemtrayicon.html#show)（）和[visible](qsystemtrayicon.html#visible-prop)。 ``` QIcon QSystemTrayIcon.icon (self) ``` [ ``` bool QSystemTrayIcon.isSystemTrayAvailable () ``` 返回True如果系統托盤可用，否則返回False 。 ](qicon.html) [如果系統盤是目前不可用，但后來變為可用，](qicon.html)[QSystemTrayIcon](qsystemtrayicon.html)會自動在系統托盤中添加一個條目，如果它是[visible](qsystemtrayicon.html#visible-prop)。 ``` bool QSystemTrayIcon.isVisible (self) ``` ``` QSystemTrayIcon.setContextMenu (self, QMenu?menu) ``` 設置指定_menu_是為系統托盤圖標的上下文菜單。用戶請求的上下文菜單中單擊鼠標按鈕，系統托盤圖標時，菜單會彈出。在Mac OS X ，這是currenly轉換為NSMenu ，所以aboutToHide （）信號未發出。 **Note:**系統托盤圖標不會拿菜單的所有權。必須確保它被刪除在適當的時間通過，例如，在創建菜單與合適的父對象。 **See also** [contextMenu](qsystemtrayicon.html#contextMenu)（）。 ``` QSystemTrayIcon.setIcon (self, QIcon?icon) ``` ``` QSystemTrayIcon.setToolTip (self, QString?tip) ``` ``` QSystemTrayIcon.setVisible (self, bool?visible) ``` 這種方法也是一個Qt槽與C + +的簽名`void setVisible(bool)`。 ``` QSystemTrayIcon.show (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void show()`。顯示在系統托盤中的圖標。 **See also** [hide](qsystemtrayicon.html#hide)（）和[visible](qsystemtrayicon.html#visible-prop)。 ``` QSystemTrayIcon.showMessage (self, QString?title, QString?msg, MessageIcon?icon?=?QSystemTrayIcon.Information, int?msecs?=?10000) ``` 示出了與給定的條目氣球消息_title_，_message_和_icon_在指定的時間_millisecondsTimeoutHint_。_title_和_message_必須是純文本字符串。消息可以由用戶進行點擊;的[messageClicked](qsystemtrayicon.html#messageClicked)當這種情況發生時（）信號會發出。注意消息的顯示依賴于系統配置和用戶偏好，而且信息可能不會出現在所有。因此，不應被依賴作為提供重要信息的唯一手段。在Windows上，_millisecondsTimeoutHint_通常被忽略的系統時，該應用程序具有焦點。在Mac OS X ，低吼通知系統必須安裝此功能來顯示消息。此功能被引入Qt的4.3 。 **See also** [show](qsystemtrayicon.html#show)（）和[supportsMessages](qsystemtrayicon.html#supportsMessages)（）。 ``` bool QSystemTrayIcon.supportsMessages () ``` 返回True如果系統托盤支持氣球的消息，否則返回False 。 **See also** [showMessage](qsystemtrayicon.html#showMessage)（）。 ``` QString QSystemTrayIcon.toolTip (self) ``` * * * ## Qt Signal Documentation ``` void activated (QSystemTrayIcon::ActivationReason) ``` 這是該信號的默認超載。當用戶激活系統托盤圖標這個信號被發射。_reason_指定用于激活的原因。[QSystemTrayIcon.ActivationReason](qsystemtrayicon.html#ActivationReason-enum)列舉的各種原因。 **See also** [QSystemTrayIcon.ActivationReason](qsystemtrayicon.html#ActivationReason-enum)。 ``` void messageClicked () ``` 這是該信號的默認超載。當使用顯示的消息這個信號被發射[showMessage](qsystemtrayicon.html#showMessage)（）被點擊的用戶。目前，這個信號沒有在Mac OS X發送 **Note:**我們遵循微軟Windows XP / Vista的行為，所以當用戶點擊并顯示氣球消息托盤圖標的信號也被發射。 **See also** [activated](qsystemtrayicon.html#activated)（）。