Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QToolTip Class Reference
[QtGui module]

该QToolTip类提供工具提示(气球帮助)任何部件。More...

Methods

Static Methods


Detailed Description

该QToolTip类提供工具提示(气球帮助)任何部件。

尖端是一个简短的一段文字,提醒小工具的功能的用户。它被画在马上一个与众不同的黑色在黄色的色彩组合给定位置下方。尖端可以是任何rich text格式化字符串。

在工具提示中显示的富文本是隐式自动换行,除非有不同的规定<p style='white-space:pre'>

设置控件的工具提示最简单和最常用的方法是通过调用其QWidget.setToolTip()函数。

另外,也可以显示不同的工具提示小窗口的不同区域,通过使用QHelpEvent类型QEvent.ToolTip。拦截在你的widget的帮助事件event()函数和调用QToolTip.showText( )与要显示的文本。该Tooltips例子说明了这种技术。

如果您呼叫QToolTip.hideText() ,或QToolTip.showText( )一个空字符串,作为一个结果ToolTip事件你也应该调用ignore()该事件,以表示你不想启动任何提示的具体模式。

需要注意的是,如果你想显示工具提示中的项目视图,模型/视图结构提供的功能来设置项的工具提示,例如,在QTableWidgetItem.setToolTip()函数。不过,如果你想提供一个项目视图自定义工具提示,您必须截取的帮助事件QAbstractItemView.viewportEvent( )函数,并自己处理。

默认的工具提示的颜色和字体可以被定制setPalette()和setFont( ) 。当工具提示目前正在展出,isVisible( )返回True,text( )当前可见的文本。

Note:工具提示使用的颜色不活跃组QPalette,因为工具提示未激活的窗口。


Method Documentation

QToolTip.__init__ (self, QToolTip)

QFont QToolTip.font ()

返回用于渲染工具提示的字体。

这个函数中引入了Qt 4.2中。

See also setFont( ) 。

QToolTip.hideText ()

隐藏工具提示。这是一样的调用showText( )用一个空字符串。

这个函数中引入了Qt 4.2中。

See also showText( ) 。

bool QToolTip.isVisible ()

如果这是提示当前显示返回True。

此功能被引入Qt的4.4 。

See also showText( ) 。

QPalette QToolTip.palette ()

返回用于渲染工具提示的调色板。

Note:工具提示使用的颜色不活跃组QPalette,因为工具提示未激活的窗口。

See also setPalette( ) 。

QToolTip.setFont (QFont)

设置font用于渲染工具提示。

这个函数中引入了Qt 4.2中。

See also font( ) 。

QToolTip.setPalette (QPalette)

设置palette用于渲染工具提示。

Note:工具提示使用的颜色不活跃组QPalette,因为工具提示未激活的窗口。

这个函数中引入了Qt 4.2中。

See also 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 (postextw,查阅QRect ())

QString QToolTip.text ()

返回的提示文本,如果提示是可见的,或一个空字符串,如果一个工具提示是不可见的。

此功能被引入Qt的4.4 。




PyQt 4.10.3 for X11 Copyright © Riverbank Computing Ltd and Nokia 2012 Qt 4.8.5