diff options
Diffstat (limited to 'doc/html/tooltip-example.html')
| -rw-r--r-- | doc/html/tooltip-example.html | 247 |
1 files changed, 247 insertions, 0 deletions
diff --git a/doc/html/tooltip-example.html b/doc/html/tooltip-example.html new file mode 100644 index 0000000..c2646b1 --- /dev/null +++ b/doc/html/tooltip-example.html @@ -0,0 +1,247 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/examples/tooltip/tooltip.doc:4 --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>Advanced use of tool tips</title> +<style type="text/css"><!-- +fn { margin-left: 1cm; text-indent: -1cm; } +a:link { color: #004faf; text-decoration: none } +a:visited { color: #672967; text-decoration: none } +body { background: #ffffff; color: black; } +--></style> +</head> +<body> + +<table border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr bgcolor="#E5E5E5"> +<td valign=center> + <a href="index.html"> +<font color="#004faf">Home</font></a> + | <a href="classes.html"> +<font color="#004faf">All Classes</font></a> + | <a href="mainclasses.html"> +<font color="#004faf">Main Classes</font></a> + | <a href="annotated.html"> +<font color="#004faf">Annotated</font></a> + | <a href="groups.html"> +<font color="#004faf">Grouped Classes</font></a> + | <a href="functions.html"> +<font color="#004faf">Functions</font></a> +</td> +<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Advanced use of tool tips</h1> + + +<p> +This example widget demonstrates how to use tool tips for static and +dynamic regions within a widget. +<p> It displays two blue and one red rectangle. The blue ones move every +time you click on them, the red one is static. There are dynamic +tool tips on the blue rectangles and a static tool tip on the red one. +<p> <hr> +<p> Header file: +<p> <pre>/**************************************************************************** +** $Id: qt/tooltip.h 3.3.8 edited Jan 11 14:37 $ +** +** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved. +** +** This file is part of an example program for Qt. This example +** program may be used, distributed and modified without limitation. +** +*****************************************************************************/ + +#include <<a href="qwidget-h.html">qwidget.h</a>> +#include <<a href="qtooltip-h.html">qtooltip.h</a>> + + +class DynamicTip : public <a href="qtooltip.html">QToolTip</a> +{ +public: + DynamicTip( <a href="qwidget.html">QWidget</a> * parent ); + +protected: + void maybeTip( const <a href="qpoint.html">QPoint</a> & ); +}; + + +class TellMe : public <a href="qwidget.html">QWidget</a> +{ + <a href="metaobjects.html#Q_OBJECT">Q_OBJECT</a> +public: + TellMe( <a href="qwidget.html">QWidget</a> * parent = 0, const char * name = 0 ); + ~TellMe(); + + <a href="qrect.html">QRect</a> tip( const <a href="qpoint.html">QPoint</a> & ); + +protected: + void paintEvent( <a href="qpaintevent.html">QPaintEvent</a> * ); + void mousePressEvent( <a href="qmouseevent.html">QMouseEvent</a> * ); + void resizeEvent( <a href="qresizeevent.html">QResizeEvent</a> * ); + +private: + <a href="qrect.html">QRect</a> randomRect(); + + <a href="qrect.html">QRect</a> r1, r2, r3; + DynamicTip * t; +}; +</pre> + +<p> <hr> +<p> Implementation: +<p> <pre>/**************************************************************************** +** $Id: qt/tooltip.cpp 3.3.8 edited Jan 11 14:37 $ +** +** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved. +** +** This file is part of an example program for Qt. This example +** program may be used, distributed and modified without limitation. +** +*****************************************************************************/ + +#include "tooltip.h" +#include <<a href="qapplication-h.html">qapplication.h</a>> +#include <<a href="qpainter-h.html">qpainter.h</a>> +#include <stdlib.h> + + +<a name="f251"></a>DynamicTip::DynamicTip( <a href="qwidget.html">QWidget</a> * parent ) + : <a href="qtooltip.html">QToolTip</a>( parent ) +{ + // no explicit initialization needed +} + + +<a name="x451"></a>void DynamicTip::<a href="qtooltip.html#maybeTip">maybeTip</a>( const <a href="qpoint.html">QPoint</a> &pos ) +{ + if ( !parentWidget()->inherits( "TellMe" ) ) + return; + + <a href="qrect.html">QRect</a> r( ((TellMe*)<a href="qtooltip.html#parentWidget">parentWidget</a>())->tip(pos) ); +<a name="x448"></a> if ( !r.<a href="qrect.html#isValid">isValid</a>() ) + return; + + <a href="qstring.html">QString</a> s; +<a name="x449"></a><a name="x447"></a> s.<a href="qstring.html#sprintf">sprintf</a>( "position: %d,%d", r.<a href="qrect.html#center">center</a>().x(), r.<a href="qrect.html#center">center</a>().y() ); + tip( r, s ); +} + + +<a name="f252"></a>TellMe::TellMe( <a href="qwidget.html">QWidget</a> * parent , const char * name ) + : <a href="qwidget.html">QWidget</a>( parent, name ) +{ + <a href="qwidget.html#setMinimumSize">setMinimumSize</a>( 30, 30 ); + r1 = randomRect(); + r2 = randomRect(); + r3 = randomRect(); + + t = new DynamicTip( this ); + +<a name="x450"></a> QToolTip::<a href="qtooltip.html#add">add</a>( this, r3, "this color is called red" ); // <- helpful +} + + +TellMe::~TellMe() +{ + delete t; + t = 0; +} + + +void TellMe::<a href="qwidget.html#paintEvent">paintEvent</a>( <a href="qpaintevent.html">QPaintEvent</a> * e ) +{ + <a href="qpainter.html">QPainter</a> p( this ); + + // I try to be efficient here, and repaint only what's needed + +<a name="x446"></a> if ( e-><a href="qpaintevent.html#rect">rect</a>().intersects( r1 ) ) { +<a name="x445"></a> p.<a href="qpainter.html#setBrush">setBrush</a>( blue ); +<a name="x444"></a> p.<a href="qpainter.html#drawRect">drawRect</a>( r1 ); + } + + if ( e-><a href="qpaintevent.html#rect">rect</a>().intersects( r2 ) ) { + p.<a href="qpainter.html#setBrush">setBrush</a>( blue ); + p.<a href="qpainter.html#drawRect">drawRect</a>( r2 ); + } + + if ( e-><a href="qpaintevent.html#rect">rect</a>().intersects( r3 ) ) { + p.<a href="qpainter.html#setBrush">setBrush</a>( red ); + p.<a href="qpainter.html#drawRect">drawRect</a>( r3 ); + } +} + + +<a name="x452"></a>void TellMe::<a href="qwidget.html#mousePressEvent">mousePressEvent</a>( <a href="qmouseevent.html">QMouseEvent</a> * e ) +{ +<a name="x443"></a> if ( r1.contains( e-><a href="qmouseevent.html#pos">pos</a>() ) ) + r1 = randomRect(); + if ( r2.contains( e-><a href="qmouseevent.html#pos">pos</a>() ) ) + r2 = randomRect(); + <a href="qwidget.html#repaint">repaint</a>(); +} + + +<a name="x454"></a>void TellMe::<a href="qwidget.html#resizeEvent">resizeEvent</a>( <a href="qresizeevent.html">QResizeEvent</a> * ) +{ + if ( !rect().contains( r1 ) ) + r1 = randomRect(); + if ( !rect().contains( r2 ) ) + r2 = randomRect(); +} + + +QRect <a name="f253"></a>TellMe::randomRect() +{ + return QRect( ::rand() % (<a href="qwidget.html#width">width</a>() - 20), ::rand() % (<a href="qwidget.html#height">height</a>() - 20), + 20, 20 ); +} + + +QRect <a name="f254"></a>TellMe::tip( const <a href="qpoint.html">QPoint</a> & p ) +{ + if ( r1.contains( p ) ) + return r1; + else if ( r2.contains( p ) ) + return r2; + else + return QRect( 0,0, -1,-1 ); +} +</pre> + +<p> <hr> +<p> Main: +<p> <pre>/**************************************************************************** +** $Id: qt/main.cpp 3.3.8 edited Jan 11 14:37 $ +** +** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved. +** +** This file is part of an example program for Qt. This example +** program may be used, distributed and modified without limitation. +** +*****************************************************************************/ + +#include <<a href="qapplication-h.html">qapplication.h</a>> +#include "tooltip.h" + +int main( int argc, char ** argv ) +{ + <a href="qapplication.html">QApplication</a> a( argc, argv ); + + TellMe mw; + mw.<a href="qwidget.html#setCaption">setCaption</a>( "Qt Example - Dynamic Tool Tips" ); + a.<a href="qapplication.html#setMainWidget">setMainWidget</a>( &mw ); + mw.<a href="qwidget.html#show">show</a>(); + + return a.<a href="qapplication.html#exec">exec</a>(); +} +</pre> + +<p>See also <a href="examples.html">Examples</a>. + +<!-- eof --> +<p><address><hr><div align=center> +<table width=100% cellspacing=0 border=0><tr> +<td>Copyright © 2007 +<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> +<td align=right><div align=right>Qt 3.3.8</div> +</table></div></address></body> +</html> |