========
Overview
A Qt package that lets you use web URLs as tooltips in Qt widgets.
- Free software: BSD 2-Clause License
Requires
PySide or PyQt4 with QtWebKit included.
Installation
::
pip install qwebtip
How To Use
Import qwebtip's main model, qweburltip
and set it to override one of
your widget's tooltips with some URL.
The next time you build your application and hover over that widget, a URL box
is displayed with that URL, instead.
.. code:: python
from qwebtip import qweburltip
url = 'http://pyqt.sourceforge.net/Docs/PyQt4/qwebframe.html'
qweburltip.override_tool_tip(QtWidgets.QLabel('Some label'), url)
How To Use - Customizing
Setting a custom tooltip size
.. code:: python
from qwebtip import qweburltip
url = 'http://pyqt.sourceforge.net/Docs/PyQt4/qwebframe.html'
qweburltip.override_tool_tip(
QtWidgets.QLabel('Some label'),
url,
width=100,
height=400,
)
Opening the URL at a specific header section
.. code:: python
url = 'http://pyqt.sourceforge.net/Docs/PyQt4/qwebframe.html'
qweburltip.override_tool_tip(
self.line_edit,
element_selector.UnknownHeaderSelector(
url,
'Method Documentation',
),
)
Disabling Caching
Loaded webpages are cached so that successive loads can be kept fast.
To disable caching, set this environment variable.
.. code:: bash
export QWEBTIP_DISABLE_CACHING=1
This is useful for debugging but is not recommended.
Changelog
0.2.0 (2019-06-02)
- Reformatted the code to use black
0.1.0 (2018-12-04)