QToolTip¶
Synopsis¶
Static functions¶
Detailed Description¶
The tip is a short piece of text reminding the user of the widget’s function. It is drawn immediately below the given position in a distinctive black-on-yellow color combination. The tip can be any
rich text
formatted string.Rich text displayed in a tool tip is implicitly word-wrapped unless specified differently with
<p style='white-space:pre'>
.The simplest and most common way to set a widget’s tool tip is by calling its
setToolTip()
function.It is also possible to show different tool tips for different regions of a widget, by using a
QHelpEvent
of typeToolTip
. Intercept the help event in your widget’sevent()
function and callshowText()
with the text you want to display. The Tooltips example illustrates this technique.If you are calling
hideText()
, orshowText()
with an empty string, as a result of aToolTip
-event you should also callignore()
on the event, to signal that you don’t want to start any tooltip specific modes.Note that, if you want to show tooltips in an item view, the model/view architecture provides functionality to set an item’s tool tip; e.g., the
setToolTip()
function. However, if you want to provide custom tool tips in an item view, you must intercept the help event in theviewportEvent()
function and handle it yourself.The default tool tip color and font can be customized with
setPalette()
andsetFont()
. When a tooltip is currently on display,isVisible()
returnstrue
andtext()
the currently visible text.Note
Tool tips use the inactive color group of
QPalette
, because tool tips are not active windows.See also
toolTip
toolTip
Tool Tips Example
- class PySide2.QtWidgets.QToolTip¶
- static PySide2.QtWidgets.QToolTip.font()¶
- Return type:
Returns the font used to render tooltips.
See also
- static PySide2.QtWidgets.QToolTip.hideText()¶
Hides the tool tip. This is the same as calling
showText()
with an empty string.See also
- static PySide2.QtWidgets.QToolTip.isVisible()¶
- Return type:
bool
Returns
true
if this tooltip is currently shown.See also
- static PySide2.QtWidgets.QToolTip.palette()¶
- Return type:
Returns the palette used to render tooltips.
Note
Tool tips use the inactive color group of
QPalette
, because tool tips are not active windows.See also
- static PySide2.QtWidgets.QToolTip.setFont(arg__1)¶
- Parameters:
arg__1 –
PySide2.QtGui.QFont
Sets the
font
used to render tooltips.See also
- static PySide2.QtWidgets.QToolTip.setPalette(arg__1)¶
- Parameters:
arg__1 –
PySide2.QtGui.QPalette
Sets the
palette
used to render tooltips.Note
Tool tips use the inactive color group of
QPalette
, because tool tips are not active windows.See also
- static PySide2.QtWidgets.QToolTip.showText(pos, text[, w=None])¶
- Parameters:
pos –
PySide2.QtCore.QPoint
text – str
This is an overloaded function.
This is analogous to calling
showText
(pos
,text
,w
, QRect())
- static PySide2.QtWidgets.QToolTip.showText(pos, text, w, rect)
- Parameters:
pos –
PySide2.QtCore.QPoint
text – str
rect –
PySide2.QtCore.QRect
Shows
text
as a tool tip, with the global positionpos
as the point of interest. The tool tip will be shown with a platform specific offset from this point of interest.If you specify a non-empty rect the tip will be hidden as soon as you move your cursor out of this area.
The
rect
is in the coordinates of the widget you specify withw
. If therect
is not empty you must specify a widget. Otherwise this argument can beNone
but it is used to determine the appropriate screen on multi-head systems.If
text
is empty the tool tip is hidden. If the text is the same as the currently shown tooltip, the tip will not move. You can force moving by first hiding the tip with an empty text, and then showing the new tip at the new position.
- static PySide2.QtWidgets.QToolTip.showText(pos, text, w, rect, msecShowTime)
- Parameters:
pos –
PySide2.QtCore.QPoint
text – str
rect –
PySide2.QtCore.QRect
msecShowTime – int
This is an overloaded function.
This is similar to
showText
(pos
,text
,w
,rect
) but with an extra parametermsecDisplayTime
that specifies how long the tool tip will be displayed, in milliseconds.
- static PySide2.QtWidgets.QToolTip.text()¶
- Return type:
str
Returns the tooltip text, if a tooltip is visible, or an empty string if a tooltip is not visible.
© 2022 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.