Custom Tooltips for PySide

To use you will need to subclass Tooltip or TooltipWithArrow and implement the getWidget function:

>>> class MyTooltip(Tooltip):
>>>   def getWidget(self):
>>>     return MyQWidget()

getWidget should return the widget that you wish to be displayed as a tooltip.

Your tooltip will need a few parameters to initialize:

>>> my_tooltip = MyTooltip(hoverable_widget, list_of_positionings, main_window, gap=7)

hoverable_widget is the widget that will trigger the tooltip.

list_of_positionings is a list of tuples: (TooltipPositioning, TooltipAlignment). TooltipPositioning can be one of Tooltips Macros: Tooltip.LEFT_POSITIONING, Tooltip.TOP_POSITIONING, Tooltip.RIGHT_POSITIONING or Tooltip.BOTTOM_POSITIONING Positionings should be TooltipWithArrow.*_POSITIONING if you chose to subclass TooltipWithArrow.

TooltipAlignment should be one of the functions included in TooltipAlignment.

Therefore, a list_of_positioning could be: [(TooltipWithArrow.RIGHT_POSITIONING, alignToTop), (TooltipWithArrow.LEFT_POSITIONING, alignToTop)].

A Tooltip will always try to use the Positioning you chose in order and will not display at all if there is no room in the screen for it.

main_window is the window in which your tooltip will display. It is used to calculate the positioning and alignment.

gap is the space in pixels between the hoverable_widget and the Tooltip.