# QToolTip Class Reference ## [[QtGui](index.htm) module] 該QToolTip類提供工具提示（氣球幫助）任何部件。[More...](#details) ### Methods * `__init__ (self, QToolTip)` ### Static Methods * `QFont font ()` * `hideText ()` * `bool isVisible ()` * `QPalette palette ()` * `setFont (QFont)` * `setPalette (QPalette)` * `showText (QPoint?pos, QString?text, QWidget?widget?=?None)` * `showText (QPoint?pos, QString?text, QWidget?w, QRect?rect)` * `QString text ()` * * * ## Detailed Description 該QToolTip類提供工具提示（氣球幫助）任何部件。 尖端是一個簡短的一段文字，提醒小工具的功能的用戶。它被畫在馬上一個與眾不同的黑色在黃色的色彩組合給定位置下方。尖端可以是任何[rich text](qtextedit.html)格式化字符串。 在工具提示中顯示的富文本是隱式自動換行，除非有不同的規定`<p style='white-space:pre'>`。 設置控件的工具提示最簡單和最常用的方法是通過調用其[QWidget.setToolTip](qwidget.html#toolTip-prop)（）函數。 另外，也可以顯示不同的工具提示小窗口的不同區域，通過使用[QHelpEvent](qhelpevent.html)類型[QEvent.ToolTip](qevent.html#Type-enum)。攔截在你的widget的幫助事件[event()](qwidget.html#event)函數和調用[QToolTip.showText](qtooltip.html#showText)（ ）與要顯示的文本。該[Tooltips](index.htm)例子說明了這種技術。 如果您呼叫[QToolTip.hideText](qtooltip.html#hideText)（） ，或[QToolTip.showText](qtooltip.html#showText)（ ）一個空字符串，作為一個結果[ToolTip](qevent.html#Type-enum)事件你也應該調用[ignore()](qevent.html#ignore)該事件，以表示你不想啟動任何提示的具體模式。 需要注意的是，如果你想顯示工具提示中的項目視圖，模型/視圖結構提供的功能來設置項的工具提示，例如，在[QTableWidgetItem.setToolTip](qtablewidgetitem.html#setToolTip)（）函數。不過，如果你想提供一個項目視圖自定義工具提示，您必須截取的幫助事件[QAbstractItemView.viewportEvent](qabstractitemview.html#viewportEvent)（ ）函數，并自己處理。 默認的工具提示的顏色和字體可以被定制[setPalette](qtooltip.html#setPalette)（）和[setFont](qtooltip.html#setFont)（ ） 。當工具提示目前正在展出，[isVisible](qtooltip.html#isVisible)（ ）返回True，[text](qtooltip.html#text)（ ）當前可見的文本。 **Note:**工具提示使用的顏色不活躍組[QPalette](qpalette.html)，因為工具提示未激活的窗口。 * * * ## Method Documentation ``` QToolTip.__init__ (self, QToolTip) ``` ``` QFont QToolTip.font () ``` [ 返回用于渲染工具提示的字體。 這個函數中引入了Qt 4.2中。 ](qfont.html) [**See also**](qfont.html) [setFont](qtooltip.html#setFont)（ ） 。 ``` QToolTip.hideText () ``` 隱藏工具提示。這是一樣的調用[showText](qtooltip.html#showText)（ ）用一個空字符串。 這個函數中引入了Qt 4.2中。 **See also** [showText](qtooltip.html#showText)（ ） 。 ``` bool QToolTip.isVisible () ``` 如果這是提示當前顯示返回True。 此功能被引入Qt的4.4 。 **See also** [showText](qtooltip.html#showText)（ ） 。 ``` QPalette QToolTip.palette () ``` [ 返回用于渲染工具提示的調色板。 ](qpalette.html) [**Note:**工具提示使用的顏色不活躍組](qpalette.html)[QPalette](qpalette.html)，因為工具提示未激活的窗口。 **See also** [setPalette](qtooltip.html#setPalette)（ ） 。 ``` QToolTip.setFont (QFont) ``` 設置_font_用于渲染工具提示。 這個函數中引入了Qt 4.2中。 **See also** [font](qtooltip.html#font)（ ） 。 ``` QToolTip.setPalette (QPalette) ``` 設置_palette_用于渲染工具提示。 **Note:**工具提示使用的顏色不活躍組[QPalette](qpalette.html)，因為工具提示未激活的窗口。 這個函數中引入了Qt 4.2中。 **See also** [palette](qtooltip.html#palette)（ ） 。 ``` QToolTip.showText (QPoint?pos, QString?text, QWidget?widget?=?None) ``` Shows _text_作為一個工具提示，與全球地位_pos_作為興趣點。工具提示會顯示有一個特定的平臺從這個興趣點偏移來。 如果您指定一個非空的矩形一角將盡快當你移動你的光標移出該區域的隱藏。 該_rect_是在你與指定窗口小部件的坐標_w_。如果_rect_是不是空的，你必須指定一個小部件。否則，這個參數可以是0 ，但它是用來確定多頭系統相應的屏幕。 If _text_是空的刀尖是隱藏的。如果文本是相同的當前顯示工具提示，針尖將_not_移動。您可以先躲在一角有一個空的文本，然后顯示在新的位置，新尖強制移動。 ``` QToolTip.showText (QPoint?pos, QString?text, QWidget?w, QRect?rect) ``` 這是一個重載函數。 這類似于調用QToolTip.showText （_pos_，_text_，_w_，查閱QRect （）） ``` QString QToolTip.text () ``` 返回的提示文本，如果提示是可見的，或一個空字符串，如果一個工具提示是不可見的。 此功能被引入Qt的4.4 。