diff options
| author | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2012-01-26 23:32:43 -0600 |
|---|---|---|
| committer | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2012-01-26 23:32:43 -0600 |
| commit | ea318d1431c89e647598c510c4245c6571aa5f46 (patch) | |
| tree | 996d29b80c30d453dda86d1a23162d441628f169 /doc/html/qwidget.html | |
| parent | aaf89d4b48f69c9293feb187db26362e550b5561 (diff) | |
| download | tqt3-ea318d1431c89e647598c510c4245c6571aa5f46.tar.gz tqt3-ea318d1431c89e647598c510c4245c6571aa5f46.zip | |
Update to latest tqt3 automated conversion
Diffstat (limited to 'doc/html/qwidget.html')
| -rw-r--r-- | doc/html/qwidget.html | 3256 |
1 files changed, 0 insertions, 3256 deletions
diff --git a/doc/html/qwidget.html b/doc/html/qwidget.html deleted file mode 100644 index a027785c1..000000000 --- a/doc/html/qwidget.html +++ /dev/null @@ -1,3256 +0,0 @@ -<!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/src/kernel/qwidget.cpp:69 --> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> -<title>TQWidget Class</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>TQWidget Class Reference</h1> - -<p>The TQWidget class is the base class of all user interface objects. -<a href="#details">More...</a> -<p><tt>#include <<a href="qwidget-h.html">qwidget.h</a>></tt> -<p>Inherits <a href="qobject.html">TQObject</a> and <a href="qpaintdevice.html">TQPaintDevice</a>. -<p>Inherited by <a href="qaxwidget.html">TQAxWidget</a>, <a href="qbutton.html">TQButton</a>, <a href="qframe.html">TQFrame</a>, <a href="qdialog.html">TQDialog</a>, <a href="qcombobox.html">TQComboBox</a>, <a href="qdatabrowser.html">TQDataBrowser</a>, <a href="qdataview.html">TQDataView</a>, <a href="qdatetimeeditbase.html">TQDateTimeEditBase</a>, <a href="qdatetimeedit.html">TQDateTimeEdit</a>, <a href="qdesktopwidget.html">TQDesktopWidget</a>, <a href="qdial.html">TQDial</a>, <a href="qdockarea.html">TQDockArea</a>, <a href="qglwidget.html">TQGLWidget</a>, <a href="qheader.html">TQHeader</a>, <a href="qmainwindow.html">TQMainWindow</a>, <a href="qmotifwidget.html">TQMotifWidget</a>, <a href="qnpwidget.html">TQNPWidget</a>, <a href="qscrollbar.html">TQScrollBar</a>, <a href="qsizegrip.html">TQSizeGrip</a>, <a href="qslider.html">TQSlider</a>, <a href="qspinbox.html">TQSpinBox</a>, <a href="qsplashscreen.html">TQSplashScreen</a>, <a href="qstatusbar.html">TQStatusBar</a>, <a href="qtabbar.html">TQTabBar</a>, <a href="qtabwidget.html">TQTabWidget</a>, <a href="qworkspace.html">TQWorkspace</a>, and <a href="qxtwidget.html">TQXtWidget</a>. -<p><a href="qwidget-members.html">List of all member functions.</a> -<h2>Public Members</h2> -<ul> -<li class=fn>explicit <a href="#TQWidget"><b>TQWidget</b></a> ( TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )</li> -<li class=fn><a href="#~TQWidget"><b>~TQWidget</b></a> ()</li> -<li class=fn>WId <a href="#winId"><b>winId</b></a> () const</li> -<li class=fn>TQStyle & <a href="#style"><b>style</b></a> () const</li> -<li class=fn>void <a href="#setStyle"><b>setStyle</b></a> ( TQStyle * style )</li> -<li class=fn>TQStyle * <a href="#setStyle-2"><b>setStyle</b></a> ( const TQString & style )</li> -<li class=fn>bool <a href="#isTopLevel"><b>isTopLevel</b></a> () const</li> -<li class=fn>bool <a href="#isDialog"><b>isDialog</b></a> () const</li> -<li class=fn>bool <a href="#isPopup"><b>isPopup</b></a> () const</li> -<li class=fn>bool <a href="#isDesktop"><b>isDesktop</b></a> () const</li> -<li class=fn>bool <a href="#isModal"><b>isModal</b></a> () const</li> -<li class=fn>bool <a href="#isEnabled"><b>isEnabled</b></a> () const</li> -<li class=fn>bool <a href="#isEnabledTo"><b>isEnabledTo</b></a> ( TQWidget * ancestor ) const</li> -<li class=fn>bool isEnabledToTLW () const <em>(obsolete)</em></li> -<li class=fn>TQRect <a href="#frameGeometry"><b>frameGeometry</b></a> () const</li> -<li class=fn>const TQRect & <a href="#geometry"><b>geometry</b></a> () const</li> -<li class=fn>int <a href="#x"><b>x</b></a> () const</li> -<li class=fn>int <a href="#y"><b>y</b></a> () const</li> -<li class=fn>TQPoint <a href="#pos"><b>pos</b></a> () const</li> -<li class=fn>TQSize <a href="#frameSize"><b>frameSize</b></a> () const</li> -<li class=fn>TQSize <a href="#size"><b>size</b></a> () const</li> -<li class=fn>int <a href="#width"><b>width</b></a> () const</li> -<li class=fn>int <a href="#height"><b>height</b></a> () const</li> -<li class=fn>TQRect <a href="#rect"><b>rect</b></a> () const</li> -<li class=fn>TQRect <a href="#childrenRect"><b>childrenRect</b></a> () const</li> -<li class=fn>TQRegion <a href="#childrenRegion"><b>childrenRegion</b></a> () const</li> -<li class=fn>TQSize <a href="#minimumSize"><b>minimumSize</b></a> () const</li> -<li class=fn>TQSize <a href="#maximumSize"><b>maximumSize</b></a> () const</li> -<li class=fn>int <a href="#minimumWidth"><b>minimumWidth</b></a> () const</li> -<li class=fn>int <a href="#minimumHeight"><b>minimumHeight</b></a> () const</li> -<li class=fn>int <a href="#maximumWidth"><b>maximumWidth</b></a> () const</li> -<li class=fn>int <a href="#maximumHeight"><b>maximumHeight</b></a> () const</li> -<li class=fn>void <a href="#setMinimumSize"><b>setMinimumSize</b></a> ( const TQSize & )</li> -<li class=fn>virtual void <a href="#setMinimumSize-2"><b>setMinimumSize</b></a> ( int minw, int minh )</li> -<li class=fn>void <a href="#setMaximumSize"><b>setMaximumSize</b></a> ( const TQSize & )</li> -<li class=fn>virtual void <a href="#setMaximumSize-2"><b>setMaximumSize</b></a> ( int maxw, int maxh )</li> -<li class=fn>void <a href="#setMinimumWidth"><b>setMinimumWidth</b></a> ( int minw )</li> -<li class=fn>void <a href="#setMinimumHeight"><b>setMinimumHeight</b></a> ( int minh )</li> -<li class=fn>void <a href="#setMaximumWidth"><b>setMaximumWidth</b></a> ( int maxw )</li> -<li class=fn>void <a href="#setMaximumHeight"><b>setMaximumHeight</b></a> ( int maxh )</li> -<li class=fn>TQSize <a href="#sizeIncrement"><b>sizeIncrement</b></a> () const</li> -<li class=fn>void <a href="#setSizeIncrement"><b>setSizeIncrement</b></a> ( const TQSize & )</li> -<li class=fn>virtual void <a href="#setSizeIncrement-2"><b>setSizeIncrement</b></a> ( int w, int h )</li> -<li class=fn>TQSize <a href="#baseSize"><b>baseSize</b></a> () const</li> -<li class=fn>void <a href="#setBaseSize"><b>setBaseSize</b></a> ( const TQSize & )</li> -<li class=fn>void <a href="#setBaseSize-2"><b>setBaseSize</b></a> ( int basew, int baseh )</li> -<li class=fn>void <a href="#setFixedSize"><b>setFixedSize</b></a> ( const TQSize & s )</li> -<li class=fn>void <a href="#setFixedSize-2"><b>setFixedSize</b></a> ( int w, int h )</li> -<li class=fn>void <a href="#setFixedWidth"><b>setFixedWidth</b></a> ( int w )</li> -<li class=fn>void <a href="#setFixedHeight"><b>setFixedHeight</b></a> ( int h )</li> -<li class=fn>TQPoint <a href="#mapToGlobal"><b>mapToGlobal</b></a> ( const TQPoint & pos ) const</li> -<li class=fn>TQPoint <a href="#mapFromGlobal"><b>mapFromGlobal</b></a> ( const TQPoint & pos ) const</li> -<li class=fn>TQPoint <a href="#mapToParent"><b>mapToParent</b></a> ( const TQPoint & pos ) const</li> -<li class=fn>TQPoint <a href="#mapFromParent"><b>mapFromParent</b></a> ( const TQPoint & pos ) const</li> -<li class=fn>TQPoint <a href="#mapTo"><b>mapTo</b></a> ( TQWidget * parent, const TQPoint & pos ) const</li> -<li class=fn>TQPoint <a href="#mapFrom"><b>mapFrom</b></a> ( TQWidget * parent, const TQPoint & pos ) const</li> -<li class=fn>TQWidget * <a href="#topLevelWidget"><b>topLevelWidget</b></a> () const</li> -<li class=fn>BackgroundMode <a href="#backgroundMode"><b>backgroundMode</b></a> () const</li> -<li class=fn>virtual void <a href="#setBackgroundMode"><b>setBackgroundMode</b></a> ( BackgroundMode )</li> -<li class=fn>void <a href="#setBackgroundMode-2"><b>setBackgroundMode</b></a> ( BackgroundMode m, BackgroundMode visual )</li> -<li class=fn>const TQColor & <a href="#foregroundColor"><b>foregroundColor</b></a> () const</li> -<li class=fn>const TQColor & <a href="#eraseColor"><b>eraseColor</b></a> () const</li> -<li class=fn>virtual void <a href="#setEraseColor"><b>setEraseColor</b></a> ( const TQColor & color )</li> -<li class=fn>const TQPixmap * <a href="#erasePixmap"><b>erasePixmap</b></a> () const</li> -<li class=fn>virtual void <a href="#setErasePixmap"><b>setErasePixmap</b></a> ( const TQPixmap & pixmap )</li> -<li class=fn>const TQColorGroup & <a href="#colorGroup"><b>colorGroup</b></a> () const</li> -<li class=fn>const TQPalette & <a href="#palette"><b>palette</b></a> () const</li> -<li class=fn>bool <a href="#ownPalette"><b>ownPalette</b></a> () const</li> -<li class=fn>virtual void <a href="#setPalette"><b>setPalette</b></a> ( const TQPalette & )</li> -<li class=fn>void <a href="#unsetPalette"><b>unsetPalette</b></a> ()</li> -<li class=fn>const TQColor & <a href="#paletteForegroundColor"><b>paletteForegroundColor</b></a> () const</li> -<li class=fn>void <a href="#setPaletteForegroundColor"><b>setPaletteForegroundColor</b></a> ( const TQColor & )</li> -<li class=fn>const TQColor & <a href="#paletteBackgroundColor"><b>paletteBackgroundColor</b></a> () const</li> -<li class=fn>virtual void <a href="#setPaletteBackgroundColor"><b>setPaletteBackgroundColor</b></a> ( const TQColor & )</li> -<li class=fn>const TQPixmap * <a href="#paletteBackgroundPixmap"><b>paletteBackgroundPixmap</b></a> () const</li> -<li class=fn>virtual void <a href="#setPaletteBackgroundPixmap"><b>setPaletteBackgroundPixmap</b></a> ( const TQPixmap & )</li> -<li class=fn>const TQBrush & <a href="#backgroundBrush"><b>backgroundBrush</b></a> () const</li> -<li class=fn>TQFont <a href="#font"><b>font</b></a> () const</li> -<li class=fn>bool <a href="#ownFont"><b>ownFont</b></a> () const</li> -<li class=fn>virtual void <a href="#setFont"><b>setFont</b></a> ( const TQFont & )</li> -<li class=fn>void <a href="#unsetFont"><b>unsetFont</b></a> ()</li> -<li class=fn>TQFontMetrics <a href="#fontMetrics"><b>fontMetrics</b></a> () const</li> -<li class=fn>TQFontInfo <a href="#fontInfo"><b>fontInfo</b></a> () const</li> -<li class=fn>const TQCursor & <a href="#cursor"><b>cursor</b></a> () const</li> -<li class=fn>bool <a href="#ownCursor"><b>ownCursor</b></a> () const</li> -<li class=fn>virtual void <a href="#setCursor"><b>setCursor</b></a> ( const TQCursor & )</li> -<li class=fn>virtual void <a href="#unsetCursor"><b>unsetCursor</b></a> ()</li> -<li class=fn>TQString <a href="#caption"><b>caption</b></a> () const</li> -<li class=fn>const TQPixmap * <a href="#icon"><b>icon</b></a> () const</li> -<li class=fn>TQString <a href="#iconText"><b>iconText</b></a> () const</li> -<li class=fn>bool <a href="#hasMouseTracking"><b>hasMouseTracking</b></a> () const</li> -<li class=fn>bool <a href="#hasMouse"><b>hasMouse</b></a> () const</li> -<li class=fn>virtual void <a href="#setMask"><b>setMask</b></a> ( const TQBitmap & bitmap )</li> -<li class=fn>virtual void <a href="#setMask-2"><b>setMask</b></a> ( const TQRegion & region )</li> -<li class=fn>void <a href="#clearMask"><b>clearMask</b></a> ()</li> -<li class=fn>const TQColor & backgroundColor () const <em>(obsolete)</em></li> -<li class=fn>virtual void setBackgroundColor ( const TQColor & c ) <em>(obsolete)</em></li> -<li class=fn>const TQPixmap * backgroundPixmap () const <em>(obsolete)</em></li> -<li class=fn>virtual void setBackgroundPixmap ( const TQPixmap & pm ) <em>(obsolete)</em></li> -<li class=fn>enum <a href="#FocusPolicy-enum"><b>FocusPolicy</b></a> { NoFocus = 0, TabFocus = 0x1, ClickFocus = 0x2, StrongFocus = TabFocus | ClickFocus | 0x8, WheelFocus = StrongFocus | 0x4 }</li> -<li class=fn>bool <a href="#isActiveWindow"><b>isActiveWindow</b></a> () const</li> -<li class=fn>virtual void <a href="#setActiveWindow"><b>setActiveWindow</b></a> ()</li> -<li class=fn>bool <a href="#isFocusEnabled"><b>isFocusEnabled</b></a> () const</li> -<li class=fn>FocusPolicy <a href="#focusPolicy"><b>focusPolicy</b></a> () const</li> -<li class=fn>virtual void <a href="#setFocusPolicy"><b>setFocusPolicy</b></a> ( FocusPolicy )</li> -<li class=fn>bool <a href="#hasFocus"><b>hasFocus</b></a> () const</li> -<li class=fn>virtual void <a href="#setFocusProxy"><b>setFocusProxy</b></a> ( TQWidget * w )</li> -<li class=fn>TQWidget * <a href="#focusProxy"><b>focusProxy</b></a> () const</li> -<li class=fn>void <a href="#setInputMethodEnabled"><b>setInputMethodEnabled</b></a> ( bool b )</li> -<li class=fn>bool <a href="#isInputMethodEnabled"><b>isInputMethodEnabled</b></a> () const</li> -<li class=fn>void <a href="#grabMouse"><b>grabMouse</b></a> ()</li> -<li class=fn>void <a href="#grabMouse-2"><b>grabMouse</b></a> ( const TQCursor & cursor )</li> -<li class=fn>void <a href="#releaseMouse"><b>releaseMouse</b></a> ()</li> -<li class=fn>void <a href="#grabKeyboard"><b>grabKeyboard</b></a> ()</li> -<li class=fn>void <a href="#releaseKeyboard"><b>releaseKeyboard</b></a> ()</li> -<li class=fn>bool <a href="#isUpdatesEnabled"><b>isUpdatesEnabled</b></a> () const</li> -<li class=fn>virtual bool <a href="#close-2"><b>close</b></a> ( bool alsoDelete )</li> -<li class=fn>bool <a href="#isVisible"><b>isVisible</b></a> () const</li> -<li class=fn>bool <a href="#isVisibleTo"><b>isVisibleTo</b></a> ( TQWidget * ancestor ) const</li> -<li class=fn>bool isVisibleToTLW () const <em>(obsolete)</em></li> -<li class=fn>TQRect visibleRect () const <em>(obsolete)</em></li> -<li class=fn>bool <a href="#isHidden"><b>isHidden</b></a> () const</li> -<li class=fn>bool <a href="#isShown"><b>isShown</b></a> () const</li> -<li class=fn>bool <a href="#isMinimized"><b>isMinimized</b></a> () const</li> -<li class=fn>bool <a href="#isMaximized"><b>isMaximized</b></a> () const</li> -<li class=fn>bool <a href="#isFullScreen"><b>isFullScreen</b></a> () const</li> -<li class=fn>uint <a href="#windowState"><b>windowState</b></a> () const</li> -<li class=fn>void <a href="#setWindowState"><b>setWindowState</b></a> ( uint windowState )</li> -<li class=fn>virtual TQSize <a href="#sizeHint"><b>sizeHint</b></a> () const</li> -<li class=fn>virtual TQSize <a href="#minimumSizeHint"><b>minimumSizeHint</b></a> () const</li> -<li class=fn>virtual TQSizePolicy <a href="#sizePolicy"><b>sizePolicy</b></a> () const</li> -<li class=fn>virtual void <a href="#setSizePolicy"><b>setSizePolicy</b></a> ( TQSizePolicy )</li> -<li class=fn>void <a href="#setSizePolicy-2"><b>setSizePolicy</b></a> ( TQSizePolicy::SizeType hor, TQSizePolicy::SizeType ver, bool hfw = FALSE )</li> -<li class=fn>virtual int <a href="#heightForWidth"><b>heightForWidth</b></a> ( int w ) const</li> -<li class=fn>TQRegion <a href="#clipRegion"><b>clipRegion</b></a> () const</li> -<li class=fn>TQLayout * <a href="#layout"><b>layout</b></a> () const</li> -<li class=fn>void <a href="#updateGeometry"><b>updateGeometry</b></a> ()</li> -<li class=fn>virtual void <a href="#reparent"><b>reparent</b></a> ( TQWidget * parent, WFlags f, const TQPoint & p, bool showIt = FALSE )</li> -<li class=fn>void <a href="#reparent-2"><b>reparent</b></a> ( TQWidget * parent, const TQPoint & p, bool showIt = FALSE )</li> -<li class=fn>void recreate ( TQWidget * parent, WFlags f, const TQPoint & p, bool showIt = FALSE ) <em>(obsolete)</em></li> -<li class=fn>void <a href="#erase-2"><b>erase</b></a> ()</li> -<li class=fn>void <a href="#erase"><b>erase</b></a> ( int x, int y, int w, int h )</li> -<li class=fn>void <a href="#erase-3"><b>erase</b></a> ( const TQRect & r )</li> -<li class=fn>void <a href="#erase-4"><b>erase</b></a> ( const TQRegion & reg )</li> -<li class=fn>void <a href="#scroll"><b>scroll</b></a> ( int dx, int dy )</li> -<li class=fn>void <a href="#scroll-2"><b>scroll</b></a> ( int dx, int dy, const TQRect & r )</li> -<li class=fn>void <a href="#drawText"><b>drawText</b></a> ( int x, int y, const TQString & str )</li> -<li class=fn>void <a href="#drawText-2"><b>drawText</b></a> ( const TQPoint & pos, const TQString & str )</li> -<li class=fn>TQWidget * <a href="#focusWidget"><b>focusWidget</b></a> () const</li> -<li class=fn>TQRect <a href="#microFocusHint"><b>microFocusHint</b></a> () const</li> -<li class=fn>bool <a href="#acceptDrops"><b>acceptDrops</b></a> () const</li> -<li class=fn>virtual void <a href="#setAcceptDrops"><b>setAcceptDrops</b></a> ( bool on )</li> -<li class=fn>virtual void <a href="#setAutoMask"><b>setAutoMask</b></a> ( bool )</li> -<li class=fn>bool <a href="#autoMask"><b>autoMask</b></a> () const</li> -<li class=fn>enum <a href="#BackgroundOrigin-enum"><b>BackgroundOrigin</b></a> { WidgetOrigin, ParentOrigin, WindowOrigin, AncestorOrigin }</li> -<li class=fn>virtual void <a href="#setBackgroundOrigin"><b>setBackgroundOrigin</b></a> ( BackgroundOrigin )</li> -<li class=fn>BackgroundOrigin <a href="#backgroundOrigin"><b>backgroundOrigin</b></a> () const</li> -<li class=fn>virtual bool <a href="#customWhatsThis"><b>customWhatsThis</b></a> () const</li> -<li class=fn>TQWidget * <a href="#parentWidget"><b>parentWidget</b></a> ( bool sameWindow = FALSE ) const</li> -<li class=fn>WFlags <a href="#testWFlags"><b>testWFlags</b></a> ( WFlags f ) const</li> -<li class=fn>TQWidget * <a href="#childAt"><b>childAt</b></a> ( int x, int y, bool includeThis = FALSE ) const</li> -<li class=fn>TQWidget * <a href="#childAt-2"><b>childAt</b></a> ( const TQPoint & p, bool includeThis = FALSE ) const</li> -<li class=fn>void <a href="#setWindowOpacity"><b>setWindowOpacity</b></a> ( double level )</li> -<li class=fn>double <a href="#windowOpacity"><b>windowOpacity</b></a> () const</li> -<li class=fn>void setPalette ( const TQPalette & p, bool ) <em>(obsolete)</em></li> -<li class=fn>void setFont ( const TQFont & f, bool ) <em>(obsolete)</em></li> -</ul> -<h2>Public Slots</h2> -<ul> -<li class=fn>virtual void <a href="#setEnabled"><b>setEnabled</b></a> ( bool )</li> -<li class=fn>void <a href="#setDisabled"><b>setDisabled</b></a> ( bool disable )</li> -<li class=fn>virtual void <a href="#setCaption"><b>setCaption</b></a> ( const TQString & )</li> -<li class=fn>virtual void <a href="#setIcon"><b>setIcon</b></a> ( const TQPixmap & )</li> -<li class=fn>virtual void <a href="#setIconText"><b>setIconText</b></a> ( const TQString & )</li> -<li class=fn>virtual void <a href="#setMouseTracking"><b>setMouseTracking</b></a> ( bool enable )</li> -<li class=fn>virtual void <a href="#setFocus"><b>setFocus</b></a> ()</li> -<li class=fn>void <a href="#clearFocus"><b>clearFocus</b></a> ()</li> -<li class=fn>virtual void <a href="#setUpdatesEnabled"><b>setUpdatesEnabled</b></a> ( bool enable )</li> -<li class=fn>void <a href="#update"><b>update</b></a> ()</li> -<li class=fn>void <a href="#update-2"><b>update</b></a> ( int x, int y, int w, int h )</li> -<li class=fn>void <a href="#update-3"><b>update</b></a> ( const TQRect & r )</li> -<li class=fn>void <a href="#repaint-2"><b>repaint</b></a> ()</li> -<li class=fn>void <a href="#repaint-3"><b>repaint</b></a> ( bool erase )</li> -<li class=fn>void <a href="#repaint"><b>repaint</b></a> ( int x, int y, int w, int h, bool erase = TRUE )</li> -<li class=fn>void <a href="#repaint-4"><b>repaint</b></a> ( const TQRect & r, bool erase = TRUE )</li> -<li class=fn>void <a href="#repaint-5"><b>repaint</b></a> ( const TQRegion & reg, bool erase = TRUE )</li> -<li class=fn>virtual void <a href="#show"><b>show</b></a> ()</li> -<li class=fn>virtual void <a href="#hide"><b>hide</b></a> ()</li> -<li class=fn>void <a href="#setShown"><b>setShown</b></a> ( bool show )</li> -<li class=fn>void <a href="#setHidden"><b>setHidden</b></a> ( bool hide )</li> -<li class=fn>void iconify () <em>(obsolete)</em></li> -<li class=fn>virtual void <a href="#showMinimized"><b>showMinimized</b></a> ()</li> -<li class=fn>virtual void <a href="#showMaximized"><b>showMaximized</b></a> ()</li> -<li class=fn>void <a href="#showFullScreen"><b>showFullScreen</b></a> ()</li> -<li class=fn>virtual void <a href="#showNormal"><b>showNormal</b></a> ()</li> -<li class=fn>virtual void <a href="#polish"><b>polish</b></a> ()</li> -<li class=fn>void <a href="#constPolish"><b>constPolish</b></a> () const</li> -<li class=fn>bool <a href="#close"><b>close</b></a> ()</li> -<li class=fn>void <a href="#raise"><b>raise</b></a> ()</li> -<li class=fn>void <a href="#lower"><b>lower</b></a> ()</li> -<li class=fn>void <a href="#stackUnder"><b>stackUnder</b></a> ( TQWidget * w )</li> -<li class=fn>virtual void <a href="#move-2"><b>move</b></a> ( int x, int y )</li> -<li class=fn>void <a href="#move"><b>move</b></a> ( const TQPoint & )</li> -<li class=fn>virtual void <a href="#resize-2"><b>resize</b></a> ( int w, int h )</li> -<li class=fn>void <a href="#resize"><b>resize</b></a> ( const TQSize & )</li> -<li class=fn>virtual void <a href="#setGeometry-2"><b>setGeometry</b></a> ( int x, int y, int w, int h )</li> -<li class=fn>virtual void <a href="#setGeometry"><b>setGeometry</b></a> ( const TQRect & )</li> -<li class=fn>virtual void <a href="#adjustSize"><b>adjustSize</b></a> ()</li> -</ul> -<h2>Static Public Members</h2> -<ul> -<li class=fn>void <a href="#setTabOrder"><b>setTabOrder</b></a> ( TQWidget * first, TQWidget * second )</li> -<li class=fn>TQWidget * <a href="#mouseGrabber"><b>mouseGrabber</b></a> ()</li> -<li class=fn>TQWidget * <a href="#keyboardGrabber"><b>keyboardGrabber</b></a> ()</li> -<li class=fn>TQWidget * <a href="#find"><b>find</b></a> ( WId id )</li> -</ul> -<h2>Properties</h2> -<ul> -<li class=fn>bool <a href="#acceptDrops-prop"><b>acceptDrops</b></a> - whether drop events are enabled for this widget</li> -<li class=fn>bool <a href="#autoMask-prop"><b>autoMask</b></a> - whether the auto mask feature is enabled for the widget</li> -<li class=fn>TQBrush <a href="#backgroundBrush-prop"><b>backgroundBrush</b></a> - the widget's background brush <em>(read only)</em></li> -<li class=fn>BackgroundMode <a href="#backgroundMode-prop"><b>backgroundMode</b></a> - the color role used for painting the background of the widget</li> -<li class=fn>BackgroundOrigin <a href="#backgroundOrigin-prop"><b>backgroundOrigin</b></a> - the origin of the widget's background</li> -<li class=fn>TQSize <a href="#baseSize-prop"><b>baseSize</b></a> - the base size of the widget</li> -<li class=fn>TQString <a href="#caption-prop"><b>caption</b></a> - the window caption (title)</li> -<li class=fn>TQRect <a href="#childrenRect-prop"><b>childrenRect</b></a> - the bounding rectangle of the widget's children <em>(read only)</em></li> -<li class=fn>TQRegion <a href="#childrenRegion-prop"><b>childrenRegion</b></a> - the combined region occupied by the widget's children <em>(read only)</em></li> -<li class=fn>TQColorGroup <a href="#colorGroup-prop"><b>colorGroup</b></a> - the current color group of the widget palette <em>(read only)</em></li> -<li class=fn>TQCursor <a href="#cursor-prop"><b>cursor</b></a> - the cursor shape for this widget</li> -<li class=fn>bool <a href="#customWhatsThis-prop"><b>customWhatsThis</b></a> - whether the widget wants to handle What's This help manually <em>(read only)</em></li> -<li class=fn>bool <a href="#enabled-prop"><b>enabled</b></a> - whether the widget is enabled</li> -<li class=fn>bool <a href="#focus-prop"><b>focus</b></a> - whether this widget (or its focus proxy) has the keyboard input focus <em>(read only)</em></li> -<li class=fn>bool <a href="#focusEnabled-prop"><b>focusEnabled</b></a> - whether the widget accepts keyboard focus <em>(read only)</em></li> -<li class=fn>FocusPolicy <a href="#focusPolicy-prop"><b>focusPolicy</b></a> - the way the widget accepts keyboard focus</li> -<li class=fn>TQFont <a href="#font-prop"><b>font</b></a> - the font currently set for the widget</li> -<li class=fn>TQRect <a href="#frameGeometry-prop"><b>frameGeometry</b></a> - geometry of the widget relative to its parent including any window frame <em>(read only)</em></li> -<li class=fn>TQSize <a href="#frameSize-prop"><b>frameSize</b></a> - the size of the widget including any window frame <em>(read only)</em></li> -<li class=fn>bool <a href="#fullScreen-prop"><b>fullScreen</b></a> - whether the widget is full screen <em>(read only)</em></li> -<li class=fn>TQRect <a href="#geometry-prop"><b>geometry</b></a> - the geometry of the widget relative to its parent and excluding the window frame</li> -<li class=fn>int <a href="#height-prop"><b>height</b></a> - the height of the widget excluding any window frame <em>(read only)</em></li> -<li class=fn>bool <a href="#hidden-prop"><b>hidden</b></a> - whether the widget is explicitly hidden</li> -<li class=fn>TQPixmap <a href="#icon-prop"><b>icon</b></a> - the widget's icon</li> -<li class=fn>TQString <a href="#iconText-prop"><b>iconText</b></a> - the widget's icon text</li> -<li class=fn>bool <a href="#inputMethodEnabled-prop"><b>inputMethodEnabled</b></a> - enables or disables the use of input methods for this widget</li> -<li class=fn>bool <a href="#isActiveWindow-prop"><b>isActiveWindow</b></a> - whether this widget is the active window <em>(read only)</em></li> -<li class=fn>bool <a href="#isDesktop-prop"><b>isDesktop</b></a> - whether the widget is a desktop widget, i.e. represents the desktop <em>(read only)</em></li> -<li class=fn>bool <a href="#isDialog-prop"><b>isDialog</b></a> - whether the widget is a dialog widget <em>(read only)</em></li> -<li class=fn>bool <a href="#isModal-prop"><b>isModal</b></a> - whether the widget is a modal widget <em>(read only)</em></li> -<li class=fn>bool <a href="#isPopup-prop"><b>isPopup</b></a> - whether the widget is a popup widget <em>(read only)</em></li> -<li class=fn>bool <a href="#isTopLevel-prop"><b>isTopLevel</b></a> - whether the widget is a top-level widget <em>(read only)</em></li> -<li class=fn>bool <a href="#maximized-prop"><b>maximized</b></a> - whether this widget is maximized <em>(read only)</em></li> -<li class=fn>int <a href="#maximumHeight-prop"><b>maximumHeight</b></a> - the widget's maximum height</li> -<li class=fn>TQSize <a href="#maximumSize-prop"><b>maximumSize</b></a> - the widget's maximum size</li> -<li class=fn>int <a href="#maximumWidth-prop"><b>maximumWidth</b></a> - the widget's maximum width</li> -<li class=fn>TQRect <a href="#microFocusHint-prop"><b>microFocusHint</b></a> - the currently set micro focus hint for this widget <em>(read only)</em></li> -<li class=fn>bool <a href="#minimized-prop"><b>minimized</b></a> - whether this widget is minimized (iconified) <em>(read only)</em></li> -<li class=fn>int <a href="#minimumHeight-prop"><b>minimumHeight</b></a> - the widget's minimum height</li> -<li class=fn>TQSize <a href="#minimumSize-prop"><b>minimumSize</b></a> - the widget's minimum size</li> -<li class=fn>TQSize <a href="#minimumSizeHint-prop"><b>minimumSizeHint</b></a> - the recommended minimum size for the widget <em>(read only)</em></li> -<li class=fn>int <a href="#minimumWidth-prop"><b>minimumWidth</b></a> - the widget's minimum width</li> -<li class=fn>bool <a href="#mouseTracking-prop"><b>mouseTracking</b></a> - whether mouse tracking is enabled for the widget</li> -<li class=fn>bool <a href="#ownCursor-prop"><b>ownCursor</b></a> - whether the widget uses its own cursor <em>(read only)</em></li> -<li class=fn>bool <a href="#ownFont-prop"><b>ownFont</b></a> - whether the widget uses its own font <em>(read only)</em></li> -<li class=fn>bool <a href="#ownPalette-prop"><b>ownPalette</b></a> - whether the widget uses its own palette <em>(read only)</em></li> -<li class=fn>TQPalette <a href="#palette-prop"><b>palette</b></a> - the widget's palette</li> -<li class=fn>TQColor <a href="#paletteBackgroundColor-prop"><b>paletteBackgroundColor</b></a> - the background color of the widget</li> -<li class=fn>TQPixmap <a href="#paletteBackgroundPixmap-prop"><b>paletteBackgroundPixmap</b></a> - the background pixmap of the widget</li> -<li class=fn>TQColor <a href="#paletteForegroundColor-prop"><b>paletteForegroundColor</b></a> - the foreground color of the widget</li> -<li class=fn>TQPoint <a href="#pos-prop"><b>pos</b></a> - the position of the widget within its parent widget</li> -<li class=fn>TQRect <a href="#rect-prop"><b>rect</b></a> - the internal geometry of the widget excluding any window frame <em>(read only)</em></li> -<li class=fn>bool <a href="#shown-prop"><b>shown</b></a> - whether the widget is shown</li> -<li class=fn>TQSize <a href="#size-prop"><b>size</b></a> - the size of the widget excluding any window frame</li> -<li class=fn>TQSize <a href="#sizeHint-prop"><b>sizeHint</b></a> - the recommended size for the widget <em>(read only)</em></li> -<li class=fn>TQSize <a href="#sizeIncrement-prop"><b>sizeIncrement</b></a> - the size increment of the widget</li> -<li class=fn>TQSizePolicy <a href="#sizePolicy-prop"><b>sizePolicy</b></a> - the default layout behavior of the widget</li> -<li class=fn>bool <a href="#underMouse-prop"><b>underMouse</b></a> - whether the widget is under the mouse cursor <em>(read only)</em></li> -<li class=fn>bool <a href="#updatesEnabled-prop"><b>updatesEnabled</b></a> - whether updates are enabled</li> -<li class=fn>bool <a href="#visible-prop"><b>visible</b></a> - whether the widget is visible <em>(read only)</em></li> -<li class=fn>TQRect visibleRect - the visible rectangle <em>(read only)</em> <em>(obsolete)</em></li> -<li class=fn>int <a href="#width-prop"><b>width</b></a> - the width of the widget excluding any window frame <em>(read only)</em></li> -<li class=fn>double <a href="#windowOpacity-prop"><b>windowOpacity</b></a> - the level of opacity for the window</li> -<li class=fn>int <a href="#x-prop"><b>x</b></a> - the x coordinate of the widget relative to its parent including any window frame <em>(read only)</em></li> -<li class=fn>int <a href="#y-prop"><b>y</b></a> - the y coordinate of the widget relative to its parent and including any window frame <em>(read only)</em></li> -</ul> -<h2>Protected Members</h2> -<ul> -<li class=fn>virtual bool <a href="#event"><b>event</b></a> ( TQEvent * e )</li> -<li class=fn>virtual void <a href="#mousePressEvent"><b>mousePressEvent</b></a> ( TQMouseEvent * e )</li> -<li class=fn>virtual void <a href="#mouseReleaseEvent"><b>mouseReleaseEvent</b></a> ( TQMouseEvent * e )</li> -<li class=fn>virtual void <a href="#mouseDoubleClickEvent"><b>mouseDoubleClickEvent</b></a> ( TQMouseEvent * e )</li> -<li class=fn>virtual void <a href="#mouseMoveEvent"><b>mouseMoveEvent</b></a> ( TQMouseEvent * e )</li> -<li class=fn>virtual void <a href="#wheelEvent"><b>wheelEvent</b></a> ( TQWheelEvent * e )</li> -<li class=fn>virtual void <a href="#keyPressEvent"><b>keyPressEvent</b></a> ( TQKeyEvent * e )</li> -<li class=fn>virtual void <a href="#keyReleaseEvent"><b>keyReleaseEvent</b></a> ( TQKeyEvent * e )</li> -<li class=fn>virtual void <a href="#focusInEvent"><b>focusInEvent</b></a> ( TQFocusEvent * )</li> -<li class=fn>virtual void <a href="#focusOutEvent"><b>focusOutEvent</b></a> ( TQFocusEvent * )</li> -<li class=fn>virtual void <a href="#enterEvent"><b>enterEvent</b></a> ( TQEvent * )</li> -<li class=fn>virtual void <a href="#leaveEvent"><b>leaveEvent</b></a> ( TQEvent * )</li> -<li class=fn>virtual void <a href="#paintEvent"><b>paintEvent</b></a> ( TQPaintEvent * )</li> -<li class=fn>virtual void <a href="#moveEvent"><b>moveEvent</b></a> ( TQMoveEvent * )</li> -<li class=fn>virtual void <a href="#resizeEvent"><b>resizeEvent</b></a> ( TQResizeEvent * )</li> -<li class=fn>virtual void <a href="#closeEvent"><b>closeEvent</b></a> ( TQCloseEvent * e )</li> -<li class=fn>virtual void <a href="#contextMenuEvent"><b>contextMenuEvent</b></a> ( TQContextMenuEvent * e )</li> -<li class=fn>virtual void <a href="#imStartEvent"><b>imStartEvent</b></a> ( TQIMEvent * e )</li> -<li class=fn>virtual void <a href="#imComposeEvent"><b>imComposeEvent</b></a> ( TQIMEvent * e )</li> -<li class=fn>virtual void <a href="#imEndEvent"><b>imEndEvent</b></a> ( TQIMEvent * e )</li> -<li class=fn>virtual void <a href="#tabletEvent"><b>tabletEvent</b></a> ( TQTabletEvent * e )</li> -<li class=fn>virtual void <a href="#dragEnterEvent"><b>dragEnterEvent</b></a> ( TQDragEnterEvent * )</li> -<li class=fn>virtual void <a href="#dragMoveEvent"><b>dragMoveEvent</b></a> ( TQDragMoveEvent * )</li> -<li class=fn>virtual void <a href="#dragLeaveEvent"><b>dragLeaveEvent</b></a> ( TQDragLeaveEvent * )</li> -<li class=fn>virtual void <a href="#dropEvent"><b>dropEvent</b></a> ( TQDropEvent * )</li> -<li class=fn>virtual void <a href="#showEvent"><b>showEvent</b></a> ( TQShowEvent * )</li> -<li class=fn>virtual void <a href="#hideEvent"><b>hideEvent</b></a> ( TQHideEvent * )</li> -<li class=fn>virtual bool <a href="#macEvent"><b>macEvent</b></a> ( MSG * )</li> -<li class=fn>virtual bool <a href="#winEvent"><b>winEvent</b></a> ( MSG * )</li> -<li class=fn>virtual bool <a href="#x11Event"><b>x11Event</b></a> ( XEvent * )</li> -<li class=fn>virtual bool <a href="#qwsEvent"><b>qwsEvent</b></a> ( TQWSEvent * )</li> -<li class=fn>virtual void <a href="#updateMask"><b>updateMask</b></a> ()</li> -<li class=fn>virtual void <a href="#styleChange"><b>styleChange</b></a> ( TQStyle & oldStyle )</li> -<li class=fn>virtual void <a href="#enabledChange"><b>enabledChange</b></a> ( bool oldEnabled )</li> -<li class=fn>virtual void <a href="#paletteChange"><b>paletteChange</b></a> ( const TQPalette & oldPalette )</li> -<li class=fn>virtual void <a href="#fontChange"><b>fontChange</b></a> ( const TQFont & oldFont )</li> -<li class=fn>virtual void <a href="#windowActivationChange"><b>windowActivationChange</b></a> ( bool oldActive )</li> -<li class=fn>virtual int <a href="#metric"><b>metric</b></a> ( int m ) const</li> -<li class=fn>void <a href="#resetInputContext"><b>resetInputContext</b></a> ()</li> -<li class=fn>virtual void <a href="#create"><b>create</b></a> ( WId window = 0, bool initializeWindow = TRUE, bool destroyOldWindow = TRUE )</li> -<li class=fn>virtual void <a href="#destroy"><b>destroy</b></a> ( bool destroyWindow = TRUE, bool destroySubWindows = TRUE )</li> -<li class=fn>WFlags <a href="#getWFlags"><b>getWFlags</b></a> () const</li> -<li class=fn>virtual void <a href="#setWFlags"><b>setWFlags</b></a> ( WFlags f )</li> -<li class=fn>void <a href="#clearWFlags"><b>clearWFlags</b></a> ( WFlags f )</li> -<li class=fn>virtual bool <a href="#focusNextPrevChild"><b>focusNextPrevChild</b></a> ( bool next )</li> -<li class=fn>TQFocusData * <a href="#focusData"><b>focusData</b></a> ()</li> -<li class=fn>virtual void <a href="#setKeyCompression"><b>setKeyCompression</b></a> ( bool compress )</li> -<li class=fn>virtual void <a href="#setMicroFocusHint"><b>setMicroFocusHint</b></a> ( int x, int y, int width, int height, bool text = TRUE, TQFont * f = 0 )</li> -</ul> -<hr><a name="details"></a><h2>Detailed Description</h2> - - -The TQWidget class is the base class of all user interface objects. -<p> - -<p> The widget is the atom of the user interface: it receives mouse, -keyboard and other events from the window system, and paints a -representation of itself on the screen. Every widget is -rectangular, and they are sorted in a Z-order. A widget is -clipped by its parent and by the widgets in front of it. -<p> A widget that isn't embedded in a parent widget is called a -top-level widget. Usually, top-level widgets are windows with a -frame and a title bar (although it is also possible to create -top-level widgets without such decoration if suitable widget flags -are used). In TQt, <a href="qmainwindow.html">TQMainWindow</a> and the various subclasses of -<a href="qdialog.html">TQDialog</a> are the most common top-level windows. -<p> A widget without a parent widget is always a top-level widget. -<p> Non-top-level widgets are child widgets. These are child windows -in their parent widgets. You cannot usually distinguish a child -widget from its parent visually. Most other widgets in TQt are -useful only as child widgets. (It is possible to make, say, a -button into a top-level widget, but most people prefer to put -their buttons inside other widgets, e.g. TQDialog.) -<p> If you want to use a TQWidget to hold child widgets you will -probably want to add a layout to the parent TQWidget. (See <a href="layout.html">Layouts</a>.) -<p> TQWidget has many member functions, but some of them have little -direct functionality: for example, TQWidget has a font property, -but never uses this itself. There are many subclasses which -provide real functionality, such as <a href="qpushbutton.html">TQPushButton</a>, <a href="qlistbox.html">TQListBox</a> and -<a href="qtabdialog.html">TQTabDialog</a>, etc. -<p> <h3> Groups of functions: -</h3> -<a name="1"></a><p> <center><table cellpadding="4" cellspacing="2" border="0"> -<tr bgcolor="#a2c511"> <th valign="top">Context <th valign="top">Functions -<tr bgcolor="#f0f0f0"> <td valign="top">Window functions <td valign="top"> -<a href="#show">show</a>(), -<a href="#hide">hide</a>(), -<a href="#raise">raise</a>(), -<a href="#lower">lower</a>(), -<a href="#close">close</a>(). -<tr bgcolor="#d0d0d0"> <td valign="top">Top level windows <td valign="top"> -<a href="#caption">caption</a>(), -<a href="#setCaption">setCaption</a>(), -<a href="#icon">icon</a>(), -<a href="#setIcon">setIcon</a>(), -<a href="#iconText">iconText</a>(), -<a href="#setIconText">setIconText</a>(), -<a href="#isActiveWindow">isActiveWindow</a>(), -<a href="#setActiveWindow">setActiveWindow</a>(), -<a href="#showMinimized">showMinimized</a>(). -<a href="#showMaximized">showMaximized</a>(), -<a href="#showFullScreen">showFullScreen</a>(), -<a href="#showNormal">showNormal</a>(). -<tr bgcolor="#f0f0f0"> <td valign="top">Window contents <td valign="top"> -<a href="#update">update</a>(), -<a href="#repaint">repaint</a>(), -<a href="#erase">erase</a>(), -<a href="#scroll">scroll</a>(), -<a href="#updateMask">updateMask</a>(). -<tr bgcolor="#d0d0d0"> <td valign="top">Geometry <td valign="top"> -<a href="#pos">pos</a>(), -<a href="#size">size</a>(), -<a href="#rect">rect</a>(), -<a href="#x">x</a>(), -<a href="#y">y</a>(), -<a href="#width">width</a>(), -<a href="#height">height</a>(), -<a href="#sizePolicy">sizePolicy</a>(), -<a href="#setSizePolicy">setSizePolicy</a>(), -<a href="#sizeHint">sizeHint</a>(), -<a href="#updateGeometry">updateGeometry</a>(), -<a href="#layout">layout</a>(), -<a href="#move">move</a>(), -<a href="#resize">resize</a>(), -<a href="#setGeometry">setGeometry</a>(), -<a href="#frameGeometry">frameGeometry</a>(), -<a href="#geometry">geometry</a>(), -<a href="#childrenRect">childrenRect</a>(), -<a href="#adjustSize">adjustSize</a>(), -<a href="#mapFromGlobal">mapFromGlobal</a>(), -<a href="#mapFromParent">mapFromParent</a>() -<a href="#mapToGlobal">mapToGlobal</a>(), -<a href="#mapToParent">mapToParent</a>(), -<a href="#maximumSize">maximumSize</a>(), -<a href="#minimumSize">minimumSize</a>(), -<a href="#sizeIncrement">sizeIncrement</a>(), -<a href="#setMaximumSize">setMaximumSize</a>(), -<a href="#setMinimumSize">setMinimumSize</a>(), -<a href="#setSizeIncrement">setSizeIncrement</a>(), -<a href="#setBaseSize">setBaseSize</a>(), -<a href="#setFixedSize">setFixedSize</a>() -<tr bgcolor="#f0f0f0"> <td valign="top">Mode <td valign="top"> -<a href="#isVisible">isVisible</a>(), -<a href="#isVisibleTo">isVisibleTo</a>(), -<a href="#isMinimized">isMinimized</a>(), -<a href="#isDesktop">isDesktop</a>(), -<a href="#isEnabled">isEnabled</a>(), -<a href="#isEnabledTo">isEnabledTo</a>(), -<a href="#isModal">isModal</a>(), -<a href="#isPopup">isPopup</a>(), -<a href="#isTopLevel">isTopLevel</a>(), -<a href="#setEnabled">setEnabled</a>(), -<a href="#hasMouseTracking">hasMouseTracking</a>(), -<a href="#setMouseTracking">setMouseTracking</a>(), -<a href="#isUpdatesEnabled">isUpdatesEnabled</a>(), -<a href="#setUpdatesEnabled">setUpdatesEnabled</a>(), -<a href="#clipRegion">clipRegion</a>(). -<tr bgcolor="#d0d0d0"> <td valign="top">Look and feel <td valign="top"> -<a href="#style">style</a>(), -<a href="#setStyle">setStyle</a>(), -<a href="#cursor">cursor</a>(), -<a href="#setCursor">setCursor</a>() -<a href="#font">font</a>(), -<a href="#setFont">setFont</a>(), -<a href="#palette">palette</a>(), -<a href="#setPalette">setPalette</a>(), -<a href="#backgroundMode">backgroundMode</a>(), -<a href="#setBackgroundMode">setBackgroundMode</a>(), -<a href="#colorGroup">colorGroup</a>(), -<a href="#fontMetrics">fontMetrics</a>(), -<a href="#fontInfo">fontInfo</a>(). -<tr bgcolor="#f0f0f0"> <td valign="top"><a href="focus.html#keyboard-focus">Keyboard focus</a><br>functions <td valign="top"> -<a href="#isFocusEnabled">isFocusEnabled</a>(), -<a href="#setFocusPolicy">setFocusPolicy</a>(), -<a href="#focusPolicy">focusPolicy</a>(), -<a href="#hasFocus">hasFocus</a>(), -<a href="#setFocus">setFocus</a>(), -<a href="#clearFocus">clearFocus</a>(), -<a href="#setTabOrder">setTabOrder</a>(), -<a href="#setFocusProxy">setFocusProxy</a>(). -<tr bgcolor="#d0d0d0"> <td valign="top">Mouse and<br>keyboard grabbing <td valign="top"> -<a href="#grabMouse">grabMouse</a>(), -<a href="#releaseMouse">releaseMouse</a>(), -<a href="#grabKeyboard">grabKeyboard</a>(), -<a href="#releaseKeyboard">releaseKeyboard</a>(), -<a href="#mouseGrabber">mouseGrabber</a>(), -<a href="#keyboardGrabber">keyboardGrabber</a>(). -<tr bgcolor="#f0f0f0"> <td valign="top">Event handlers <td valign="top"> -<a href="#event">event</a>(), -<a href="#mousePressEvent">mousePressEvent</a>(), -<a href="#mouseReleaseEvent">mouseReleaseEvent</a>(), -<a href="#mouseDoubleClickEvent">mouseDoubleClickEvent</a>(), -<a href="#mouseMoveEvent">mouseMoveEvent</a>(), -<a href="#keyPressEvent">keyPressEvent</a>(), -<a href="#keyReleaseEvent">keyReleaseEvent</a>(), -<a href="#focusInEvent">focusInEvent</a>(), -<a href="#focusOutEvent">focusOutEvent</a>(), -<a href="#wheelEvent">wheelEvent</a>(), -<a href="#enterEvent">enterEvent</a>(), -<a href="#leaveEvent">leaveEvent</a>(), -<a href="#paintEvent">paintEvent</a>(), -<a href="#moveEvent">moveEvent</a>(), -<a href="#resizeEvent">resizeEvent</a>(), -<a href="#closeEvent">closeEvent</a>(), -<a href="#dragEnterEvent">dragEnterEvent</a>(), -<a href="#dragMoveEvent">dragMoveEvent</a>(), -<a href="#dragLeaveEvent">dragLeaveEvent</a>(), -<a href="#dropEvent">dropEvent</a>(), -<a href="qobject.html#childEvent">childEvent</a>(), -<a href="#showEvent">showEvent</a>(), -<a href="#hideEvent">hideEvent</a>(), -<a href="qobject.html#customEvent">customEvent</a>(). -<tr bgcolor="#d0d0d0"> <td valign="top">Change handlers <td valign="top"> -<a href="#enabledChange">enabledChange</a>(), -<a href="#fontChange">fontChange</a>(), -<a href="#paletteChange">paletteChange</a>(), -<a href="#styleChange">styleChange</a>(), -<a href="#windowActivationChange">windowActivationChange</a>(). -<tr bgcolor="#f0f0f0"> <td valign="top">System functions <td valign="top"> -<a href="#parentWidget">parentWidget</a>(), -<a href="#topLevelWidget">topLevelWidget</a>(), -<a href="#reparent">reparent</a>(), -<a href="#polish">polish</a>(), -<a href="#winId">winId</a>(), -<a href="#find">find</a>(), -<a href="#metric">metric</a>(). -<tr bgcolor="#d0d0d0"> <td valign="top">What's this help <td valign="top"> -<a href="#customWhatsThis">customWhatsThis</a>() -<tr bgcolor="#f0f0f0"> <td valign="top">Internal kernel<br>functions <td valign="top"> -<a href="#focusNextPrevChild">focusNextPrevChild</a>(), -wmapper(), -<a href="#clearWFlags">clearWFlags</a>(), -<a href="#getWFlags">getWFlags</a>(), -<a href="#setWFlags">setWFlags</a>(), -<a href="#testWFlags">testWFlags</a>(). -<p> </table></center> -<p> Every widget's constructor accepts two or three standard arguments: -<ol type=1> -<li> <tt>TQWidget *parent = 0</tt> is the parent of the new widget. -If it is 0 (the default), the new widget will be a top-level window. -If not, it will be a child of <em>parent</em>, and be constrained by <em>parent</em>'s geometry (unless you specify <a href="qt.html#WidgetFlags-enum">WType_TopLevel</a> as -<a href="qt.html#WidgetFlags">widget flag</a>). -<li> <tt>const char *name = 0</tt> is the widget name of the new -widget. You can access it using <a href="qobject.html#name">name</a>(). The widget name is little -used by programmers but is quite useful with GUI builders such as -<em>TQt Designer</em> (you can name a widget in <em>TQt Designer</em>, and -<a href="qobject.html#connect">connect</a>() to it using the name in your code). The <a href="qobject.html#dumpObjectTree">dumpObjectTree</a>() -debugging function also uses it. -<li> <tt>WFlags f = 0</tt> (where available) sets the widget flags; the -default is suitable for almost all widgets, but to get, for -example, a top-level widget without a window system frame, you -must use special flags. -</ol> -<p> The tictac/tictac.cpp example program is good example of a simple -widget. It contains a few event handlers (as all widgets must), a -few custom routines that are specific to it (as all useful widgets -do), and has a few children and connections. Everything it does -is done in response to an event: this is by far the most common way -to design GUI applications. -<p> You will need to supply the content for your widgets yourself, but -here is a brief run-down of the events, starting with the most common -ones: -<p> <ul> -<p> <li> <a href="#paintEvent">paintEvent</a>() - called whenever the widget needs to be -repainted. Every widget which displays output must implement it, -and it is wise <em>not</em> to paint on the screen outside -paintEvent(). -<p> <li> <a href="#resizeEvent">resizeEvent</a>() - called when the widget has been resized. -<p> <li> <a href="#mousePressEvent">mousePressEvent</a>() - called when a mouse button is pressed. -There are six mouse-related events, but the mouse press and mouse -release events are by far the most important. A widget receives -mouse press events when the mouse is inside it, or when it has -grabbed the mouse using <a href="#grabMouse">grabMouse</a>(). -<p> <li> <a href="#mouseReleaseEvent">mouseReleaseEvent</a>() - called when a mouse button is released. -A widget receives mouse release events when it has received the -corresponding mouse press event. This means that if the user -presses the mouse inside <em>your</em> widget, then drags the mouse to -somewhere else, then releases, <em>your</em> widget receives the release -event. There is one exception: if a popup menu appears while the -mouse button is held down, this popup immediately steals the mouse -events. -<p> <li> <a href="#mouseDoubleClickEvent">mouseDoubleClickEvent</a>() - not quite as obvious as it might seem. -If the user double-clicks, the widget receives a mouse press event -(perhaps a mouse move event or two if they don't hold the mouse -quite steady), a mouse release event and finally this event. It is -<em>not possible</em> to distinguish a click from a double click until you've -seen whether the second click arrives. (This is one reason why most GUI -books recommend that double clicks be an extension of single clicks, -rather than trigger a different action.) -<p> </ul> -<p> If your widget only contains child widgets, you probably do not need to -implement any event handlers. If you want to detect a mouse click in -a child widget call the child's <a href="#hasMouse">hasMouse</a>() function inside the -parent widget's <a href="#mousePressEvent">mousePressEvent</a>(). -<p> Widgets that accept keyboard input need to reimplement a few more -event handlers: -<p> <ul> -<p> <li> <a href="#keyPressEvent">keyPressEvent</a>() - called whenever a key is pressed, and again -when a key has been held down long enough for it to auto-repeat. -Note that the Tab and Shift+Tab keys are only passed to the widget -if they are not used by the focus-change mechanisms. To force those -keys to be processed by your widget, you must reimplement -<a href="#event">TQWidget::event</a>(). -<p> <li> <a href="#focusInEvent">focusInEvent</a>() - called when the widget gains keyboard focus -(assuming you have called <a href="#setFocusPolicy">setFocusPolicy</a>()). Well written widgets -indicate that they own the keyboard focus in a clear but discreet -way. -<p> <li> <a href="#focusOutEvent">focusOutEvent</a>() - called when the widget loses keyboard focus. -<p> </ul> -<p> Some widgets will also need to reimplement some of the less common -event handlers: -<p> <ul> -<p> <li> <a href="#mouseMoveEvent">mouseMoveEvent</a>() - called whenever the mouse moves while a -button is held down. This is useful for, for example, dragging. If -you call <a href="#setMouseTracking">setMouseTracking</a>(TRUE), you get mouse move events even -when no buttons are held down. (Note that applications which make -use of mouse tracking are often not very useful on low-bandwidth X -connections.) (See also the <a href="dnd.html">drag and drop</a> -information.) -<p> <li> <a href="#keyReleaseEvent">keyReleaseEvent</a>() - called whenever a key is released, and also -while it is held down if the key is auto-repeating. In that case -the widget receives a key release event and immediately a key press -event for every repeat. Note that the Tab and Shift+Tab keys are -only passed to the widget if they are not used by the focus-change -mechanisms. To force those keys to be processed by your widget, you -must reimplement <a href="#event">TQWidget::event</a>(). -<p> <li> <a href="#wheelEvent">wheelEvent</a>() -- called whenever the user turns the mouse wheel -while the widget has the focus. -<p> <li> <a href="#enterEvent">enterEvent</a>() - called when the mouse enters the widget's screen -space. (This excludes screen space owned by any children of the -widget.) -<p> <li> <a href="#leaveEvent">leaveEvent</a>() - called when the mouse leaves the widget's screen -space. -<p> <li> <a href="#moveEvent">moveEvent</a>() - called when the widget has been moved relative to its -parent. -<p> <li> <a href="#closeEvent">closeEvent</a>() - called when the user closes the widget (or when -<a href="#close">close</a>() is called). -<p> </ul> -<p> There are also some rather obscure events. They are listed in -<a href="qevent-h.html">qevent.h</a> and you need to reimplement <a href="#event">event</a>() to handle them. -The default implementation of event() handles Tab and Shift+Tab -(to move the keyboard focus), and passes on most other events to -one of the more specialized handlers above. -<p> When implementing a widget, there are a few more things to -consider. -<p> <ul> -<p> <li> In the constructor, be sure to set up your member variables -early on, before there's any chance that you might receive an event. -<p> <li> It is almost always useful to reimplement <a href="#sizeHint">sizeHint</a>() and to set -the correct size policy with <a href="#setSizePolicy">setSizePolicy</a>(), so users of your class -can set up layout management more easily. A size policy lets you -supply good defaults for the layout management handling, so that -other widgets can contain and manage yours easily. sizeHint() -indicates a "good" size for the widget. -<p> <li> If your widget is a top-level window, <a href="#setCaption">setCaption</a>() and <a href="#setIcon">setIcon</a>() set -the title bar and icon respectively. -<p> </ul> -<p> <p>See also <a href="qevent.html">TQEvent</a>, <a href="qpainter.html">TQPainter</a>, <a href="qgridlayout.html">TQGridLayout</a>, <a href="qboxlayout.html">TQBoxLayout</a>, and <a href="abstractwidgets.html">Abstract Widget Classes</a>. - -<hr><h2>Member Type Documentation</h2> -<h3 class=fn><a name="BackgroundOrigin-enum"></a>TQWidget::BackgroundOrigin</h3> - -<p> This enum defines the origin used to draw a widget's background -pixmap. -<p> The pixmap is drawn using the: -<ul> -<li><tt>TQWidget::WidgetOrigin</tt> - widget's coordinate system. -<li><tt>TQWidget::ParentOrigin</tt> - parent's coordinate system. -<li><tt>TQWidget::WindowOrigin</tt> - top-level window's coordinate system. -<li><tt>TQWidget::AncestorOrigin</tt> - same origin as the parent uses. -</ul> -<h3 class=fn><a name="FocusPolicy-enum"></a>TQWidget::FocusPolicy</h3> - -<p> This enum type defines the various policies a widget can have with -respect to actquiring <a href="focus.html#keyboard-focus">keyboard focus</a>. -<ul> -<li><tt>TQWidget::TabFocus</tt> - the widget accepts focus by tabbing. -<li><tt>TQWidget::ClickFocus</tt> - the widget accepts focus by clicking. -<li><tt>TQWidget::StrongFocus</tt> - the widget accepts focus by both tabbing -and clicking. On Mac OS X this will also -be indicate that the widget accepts tab focus -when in 'Text/List focus mode'. -<li><tt>TQWidget::WheelFocus</tt> - like StrongFocus plus the widget accepts -focus by using the mouse wheel. -<li><tt>TQWidget::NoFocus</tt> - the widget does not accept focus. -</ul><p> -<hr><h2>Member Function Documentation</h2> -<h3 class=fn>explicit <a name="TQWidget"></a>TQWidget::TQWidget ( <a href="qwidget.html">TQWidget</a> * parent = 0, const char * name = 0, WFlags f = 0 ) -</h3> -Constructs a widget which is a child of <em>parent</em>, with the name -<em>name</em> and widget flags set to <em>f</em>. -<p> If <em>parent</em> is 0, the new widget becomes a top-level window. If -<em>parent</em> is another widget, this widget becomes a child window -inside <em>parent</em>. The new widget is deleted when its <em>parent</em> is -deleted. -<p> The <em>name</em> is sent to the <a href="qobject.html">TQObject</a> constructor. -<p> The widget flags argument, <em>f</em>, is normally 0, but it can be set -to customize the window frame of a top-level widget (i.e. <em>parent</em> must be 0). To customize the frame, set the <a href="qt.html#WidgetFlags-enum">WStyle_Customize</a> flag OR'ed with any of the <a href="qt.html#WidgetFlags-enum">TQt::WidgetFlags</a>. -<p> If you add a child widget to an already visible widget you must -explicitly show the child to make it visible. -<p> Note that the X11 version of TQt may not be able to deliver all -combinations of style flags on all systems. This is because on -X11, TQt can only ask the window manager, and the window manager -can override the application's settings. On Windows, TQt can set -whatever flags you want. -<p> Example: -<pre> - <a href="qlabel.html">TQLabel</a> *splashScreen = new <a href="qlabel.html">TQLabel</a>( 0, "mySplashScreen", - WStyle_Customize | WStyle_Splash ); - </pre> - - -<h3 class=fn><a name="~TQWidget"></a>TQWidget::~TQWidget () -</h3> -Destroys the widget. -<p> All this widget's children are deleted first. The application -exits if this widget is the main widget. - -<h3 class=fn>bool <a name="acceptDrops"></a>TQWidget::acceptDrops () const -</h3><p>Returns TRUE if drop events are enabled for this widget; otherwise returns FALSE. -See the <a href="qwidget.html#acceptDrops-prop">"acceptDrops"</a> property for details. -<h3 class=fn>void <a name="adjustSize"></a>TQWidget::adjustSize ()<tt> [virtual slot]</tt> -</h3> -Adjusts the size of the widget to fit the contents. -<p> Uses <a href="#sizeHint">sizeHint</a>() if valid (i.e if the size hint's width and height -are >= 0), otherwise sets the size to the children rectangle (the -union of all child widget geometries). -<p> <p>See also <a href="#sizeHint-prop">sizeHint</a> and <a href="#childrenRect-prop">childrenRect</a>. - -<p>Example: <a href="xform-example.html#x1266">xform/xform.cpp</a>. -<p>Reimplemented in <a href="qmessagebox.html#adjustSize">TQMessageBox</a>. -<h3 class=fn>bool <a name="autoMask"></a>TQWidget::autoMask () const -</h3><p>Returns TRUE if the auto mask feature is enabled for the widget; otherwise returns FALSE. -See the <a href="qwidget.html#autoMask-prop">"autoMask"</a> property for details. -<h3 class=fn>const <a href="qbrush.html">TQBrush</a> & <a name="backgroundBrush"></a>TQWidget::backgroundBrush () const -</h3><p>Returns the widget's background brush. -See the <a href="qwidget.html#backgroundBrush-prop">"backgroundBrush"</a> property for details. -<h3 class=fn>const <a href="qcolor.html">TQColor</a> & <a name="backgroundColor"></a>TQWidget::backgroundColor () const -</h3><b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -Use <a href="#paletteBackgroundColor">paletteBackgroundColor</a>() or <a href="#eraseColor">eraseColor</a>() instead. -<h3 class=fn><a href="qt.html#BackgroundMode-enum">BackgroundMode</a> <a name="backgroundMode"></a>TQWidget::backgroundMode () const -</h3><p>Returns the color role used for painting the background of the widget. -See the <a href="qwidget.html#backgroundMode-prop">"backgroundMode"</a> property for details. -<h3 class=fn><a href="qwidget.html#BackgroundOrigin-enum">BackgroundOrigin</a> <a name="backgroundOrigin"></a>TQWidget::backgroundOrigin () const -</h3><p>Returns the origin of the widget's background. -See the <a href="qwidget.html#backgroundOrigin-prop">"backgroundOrigin"</a> property for details. -<h3 class=fn>const <a href="qpixmap.html">TQPixmap</a> * <a name="backgroundPixmap"></a>TQWidget::backgroundPixmap () const -</h3><b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -Use <a href="#paletteBackgroundPixmap">paletteBackgroundPixmap</a>() or <a href="#erasePixmap">erasePixmap</a>() instead. -<p>Examples: <a href="themes-example.html#x305">themes/metal.cpp</a> and <a href="themes-example.html#x250">themes/wood.cpp</a>. -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="baseSize"></a>TQWidget::baseSize () const -</h3><p>Returns the base size of the widget. -See the <a href="qwidget.html#baseSize-prop">"baseSize"</a> property for details. -<h3 class=fn><a href="qstring.html">TQString</a> <a name="caption"></a>TQWidget::caption () const -</h3><p>Returns the window caption (title). -See the <a href="qwidget.html#caption-prop">"caption"</a> property for details. -<h3 class=fn><a href="qwidget.html">TQWidget</a> * <a name="childAt"></a>TQWidget::childAt ( int x, int y, bool includeThis = FALSE ) const -</h3> -Returns the visible child widget at pixel position <em>(x, y)</em> in -the widget's own coordinate system. -<p> If <em>includeThis</em> is TRUE, and there is no child visible at <em>(x, y)</em>, the widget itself is returned. - -<h3 class=fn><a href="qwidget.html">TQWidget</a> * <a name="childAt-2"></a>TQWidget::childAt ( const <a href="qpoint.html">TQPoint</a> & p, bool includeThis = FALSE ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Returns the visible child widget at point <em>p</em> in the widget's own -coordinate system. -<p> If <em>includeThis</em> is TRUE, and there is no child visible at <em>p</em>, -the widget itself is returned. -<p> -<h3 class=fn><a href="qrect.html">TQRect</a> <a name="childrenRect"></a>TQWidget::childrenRect () const -</h3><p>Returns the bounding rectangle of the widget's children. -See the <a href="qwidget.html#childrenRect-prop">"childrenRect"</a> property for details. -<h3 class=fn><a href="qregion.html">TQRegion</a> <a name="childrenRegion"></a>TQWidget::childrenRegion () const -</h3><p>Returns the combined region occupied by the widget's children. -See the <a href="qwidget.html#childrenRegion-prop">"childrenRegion"</a> property for details. -<h3 class=fn>void <a name="clearFocus"></a>TQWidget::clearFocus ()<tt> [slot]</tt> -</h3> -Takes keyboard input focus from the widget. -<p> If the widget has active focus, a <a href="#focusOutEvent">focus out - event</a> is sent to this widget to tell it that it is about -to lose the focus. -<p> This widget must enable focus setting in order to get the keyboard -input focus, i.e. it must call <a href="#setFocusPolicy">setFocusPolicy</a>(). -<p> <p>See also <a href="#focus-prop">focus</a>, <a href="#setFocus">setFocus</a>(), <a href="#focusInEvent">focusInEvent</a>(), <a href="#focusOutEvent">focusOutEvent</a>(), <a href="#focusPolicy-prop">focusPolicy</a>, and <a href="qapplication.html#focusWidget">TQApplication::focusWidget</a>(). - -<h3 class=fn>void <a name="clearMask"></a>TQWidget::clearMask () -</h3> -Removes any mask set by <a href="#setMask">setMask</a>(). -<p> <p>See also <a href="#setMask">setMask</a>(). - -<h3 class=fn>void <a name="clearWFlags"></a>TQWidget::clearWFlags ( WFlags f )<tt> [protected]</tt> -</h3> - -<p> Clears the widget flags <em>f</em>. -<p> Widget flags are a combination of <a href="qt.html#WidgetFlags-enum">TQt::WidgetFlags</a>. -<p> <p>See also <a href="#testWFlags">testWFlags</a>(), <a href="#getWFlags">getWFlags</a>(), and <a href="#setWFlags">setWFlags</a>(). - -<h3 class=fn><a href="qregion.html">TQRegion</a> <a name="clipRegion"></a>TQWidget::clipRegion () const -</h3> -Returns the unobscured region where paint events can occur. -<p> For visible widgets, this is an approximation of the area not -covered by other widgets; otherwise, this is an empty region. -<p> The <a href="#repaint">repaint</a>() function calls this function if necessary, so in -general you do not need to call it. -<p> -<h3 class=fn>bool <a name="close"></a>TQWidget::close ()<tt> [slot]</tt> -</h3> - -<p> Closes this widget. Returns TRUE if the widget was closed; -otherwise returns FALSE. -<p> First it sends the widget a <a href="qcloseevent.html">TQCloseEvent</a>. The widget is <a href="#hide">hidden</a> if it <a href="qcloseevent.html#accept">accepts</a> the close event. The default implementation of -<a href="#closeEvent">TQWidget::closeEvent</a>() accepts the close event. -<p> The <a href="qapplication.html#lastWindowClosed">TQApplication::lastWindowClosed</a>() signal is emitted when the -last visible top level widget is closed. -<p> -<p>Examples: <a href="motif-dialog-example.html#x2708">dialog/mainwindow.cpp</a>, <a href="mdi-example.html#x2076">mdi/application.cpp</a>, <a href="popup-example.html#x1616">popup/popup.cpp</a>, and <a href="toplevel-example.html#x2535">toplevel/options.ui.h</a>. -<h3 class=fn>bool <a name="close-2"></a>TQWidget::close ( bool alsoDelete )<tt> [virtual]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Closes this widget. Returns TRUE if the widget was closed; -otherwise returns FALSE. -<p> If <em>alsoDelete</em> is TRUE or the widget has the <a href="qt.html#WidgetFlags-enum">WDestructiveClose</a> widget flag, the widget is also deleted. The -widget can prevent itself from being closed by rejecting the -<a href="qcloseevent.html">TQCloseEvent</a> it gets. A close events is delivered to the widget -no matter if the widget is visible or not. -<p> The <a href="qapplication.html#lastWindowClosed">TQApplication::lastWindowClosed</a>() signal is emitted when the -last visible top level widget is closed. -<p> Note that closing the <a href="qapplication.html#mainWidget">TQApplication::mainWidget</a>() terminates the -application. -<p> <p>See also <a href="#closeEvent">closeEvent</a>(), <a href="qcloseevent.html">TQCloseEvent</a>, <a href="#hide">hide</a>(), <a href="qapplication.html#quit">TQApplication::quit</a>(), <a href="qapplication.html#setMainWidget">TQApplication::setMainWidget</a>(), and <a href="qapplication.html#lastWindowClosed">TQApplication::lastWindowClosed</a>(). - -<h3 class=fn>void <a name="closeEvent"></a>TQWidget::closeEvent ( <a href="qcloseevent.html">TQCloseEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler, for event <em>e</em>, can be reimplemented in a -subclass to receive widget close events. -<p> The default implementation calls e->accept(), which hides this -widget. See the <a href="qcloseevent.html">TQCloseEvent</a> documentation for more details. -<p> <p>See also <a href="#event">event</a>(), <a href="#hide">hide</a>(), <a href="#close">close</a>(), and <a href="qcloseevent.html">TQCloseEvent</a>. - -<p>Examples: <a href="qaction-application-example.html#x1173">action/application.cpp</a>, <a href="simple-application-example.html#x1592">application/application.cpp</a>, <a href="canvas-chart-example.html#x2896">chart/chartform.cpp</a>, <a href="i18n-example.html#x1927">i18n/mywidget.cpp</a>, <a href="mdi-example.html#x2077">mdi/application.cpp</a>, <a href="popup-example.html#x1617">popup/popup.cpp</a>, and <a href="qwerty-example.html#x404">qwerty/qwerty.cpp</a>. -<h3 class=fn>const <a href="qcolorgroup.html">TQColorGroup</a> & <a name="colorGroup"></a>TQWidget::colorGroup () const -</h3><p>Returns the current color group of the widget palette. -See the <a href="qwidget.html#colorGroup-prop">"colorGroup"</a> property for details. -<h3 class=fn>void <a name="constPolish"></a>TQWidget::constPolish () const<tt> [slot]</tt> -</h3> - -<p> Ensures that the widget is properly initialized by calling -<a href="#polish">polish</a>(). -<p> Call <a href="#constPolish">constPolish</a>() from functions like <a href="#sizeHint">sizeHint</a>() that depends on -the widget being initialized, and that may be called before -<a href="#show">show</a>(). -<p> <b>Warning:</b> Do not call constPolish() on a widget from inside that -widget's constructor. -<p> <p>See also <a href="#polish">polish</a>(). - -<h3 class=fn>void <a name="contextMenuEvent"></a>TQWidget::contextMenuEvent ( <a href="qcontextmenuevent.html">TQContextMenuEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler, for event <em>e</em>, can be reimplemented in a -subclass to receive widget context menu events. -<p> The default implementation calls e->ignore(), which rejects the -context event. See the <a href="qcontextmenuevent.html">TQContextMenuEvent</a> documentation for -more details. -<p> <p>See also <a href="#event">event</a>() and <a href="qcontextmenuevent.html">TQContextMenuEvent</a>. - -<p>Example: <a href="menu-example.html#x1881">menu/menu.cpp</a>. -<h3 class=fn>void <a name="create"></a>TQWidget::create ( WId window = 0, bool initializeWindow = TRUE, bool destroyOldWindow = TRUE )<tt> [virtual protected]</tt> -</h3> -Creates a new widget window if <em>window</em> is 0, otherwise sets the -widget's window to <em>window</em>. -<p> Initializes the window (sets the geometry etc.) if <em>initializeWindow</em> is TRUE. If <em>initializeWindow</em> is FALSE, no -initialization is performed. This parameter only makes sense if <em>window</em> is a valid window. -<p> Destroys the old window if <em>destroyOldWindow</em> is TRUE. If <em>destroyOldWindow</em> is FALSE, you are responsible for destroying the -window yourself (using platform native code). -<p> The TQWidget constructor calls <a href="#create">create</a>(0,TRUE,TRUE) to create a -window for this widget. - -<h3 class=fn>const <a href="qcursor.html">TQCursor</a> & <a name="cursor"></a>TQWidget::cursor () const -</h3><p>Returns the cursor shape for this widget. -See the <a href="qwidget.html#cursor-prop">"cursor"</a> property for details. -<h3 class=fn>bool <a name="customWhatsThis"></a>TQWidget::customWhatsThis () const<tt> [virtual]</tt> -</h3><p>Returns TRUE if the widget wants to handle What's This help manually; otherwise returns FALSE. -See the <a href="qwidget.html#customWhatsThis-prop">"customWhatsThis"</a> property for details. -<h3 class=fn>void <a name="destroy"></a>TQWidget::destroy ( bool destroyWindow = TRUE, bool destroySubWindows = TRUE )<tt> [virtual protected]</tt> -</h3> -Frees up window system resources. Destroys the widget window if <em>destroyWindow</em> is TRUE. -<p> <a href="#destroy">destroy</a>() calls itself recursively for all the child widgets, -passing <em>destroySubWindows</em> for the <em>destroyWindow</em> parameter. -To have more control over destruction of subwidgets, destroy -subwidgets selectively first. -<p> This function is usually called from the TQWidget destructor. - -<h3 class=fn>void <a name="dragEnterEvent"></a>TQWidget::dragEnterEvent ( <a href="qdragenterevent.html">TQDragEnterEvent</a> * )<tt> [virtual protected]</tt> -</h3> -This event handler is called when a drag is in progress and the -mouse enters this widget. -<p> See the <a href="dnd.html">Drag-and-drop documentation</a> for an -overview of how to provide drag-and-drop in your application. -<p> <p>See also <a href="qtextdrag.html">TQTextDrag</a>, <a href="qimagedrag.html">TQImageDrag</a>, and <a href="qdragenterevent.html">TQDragEnterEvent</a>. - -<p>Example: <a href="simple_dd-example.html#x2829">iconview/simple_dd/main.cpp</a>. -<h3 class=fn>void <a name="dragLeaveEvent"></a>TQWidget::dragLeaveEvent ( <a href="qdragleaveevent.html">TQDragLeaveEvent</a> * )<tt> [virtual protected]</tt> -</h3> -This event handler is called when a drag is in progress and the -mouse leaves this widget. -<p> See the <a href="dnd.html">Drag-and-drop documentation</a> for an -overview of how to provide drag-and-drop in your application. -<p> <p>See also <a href="qtextdrag.html">TQTextDrag</a>, <a href="qimagedrag.html">TQImageDrag</a>, and <a href="qdragleaveevent.html">TQDragLeaveEvent</a>. - -<h3 class=fn>void <a name="dragMoveEvent"></a>TQWidget::dragMoveEvent ( <a href="qdragmoveevent.html">TQDragMoveEvent</a> * )<tt> [virtual protected]</tt> -</h3> -This event handler is called when a drag is in progress and the -mouse enters this widget, and whenever it moves within the widget. -<p> See the <a href="dnd.html">Drag-and-drop documentation</a> for an -overview of how to provide drag-and-drop in your application. -<p> <p>See also <a href="qtextdrag.html">TQTextDrag</a>, <a href="qimagedrag.html">TQImageDrag</a>, and <a href="qdragmoveevent.html">TQDragMoveEvent</a>. - -<h3 class=fn>void <a name="drawText"></a>TQWidget::drawText ( int x, int y, const <a href="qstring.html">TQString</a> & str ) -</h3> -Draws the string <em>str</em> at position <em>(x, y)</em>. -<p> The <em>y</em> position is the base line position of the text. The text -is drawn using the default font and the default foreground color. -<p> This function is provided for convenience. You will generally get -more flexible results and often higher speed by using a a <a href="qpainter.html">painter</a> instead. -<p> <p>See also <a href="#font-prop">font</a>, <a href="#foregroundColor">foregroundColor</a>(), and <a href="qpainter.html#drawText">TQPainter::drawText</a>(). - -<h3 class=fn>void <a name="drawText-2"></a>TQWidget::drawText ( const <a href="qpoint.html">TQPoint</a> & pos, const <a href="qstring.html">TQString</a> & str ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Draws the string <em>str</em> at position <em>pos</em>. - -<h3 class=fn>void <a name="dropEvent"></a>TQWidget::dropEvent ( <a href="qdropevent.html">TQDropEvent</a> * )<tt> [virtual protected]</tt> -</h3> -This event handler is called when the drag is dropped on this -widget. -<p> See the <a href="dnd.html">Drag-and-drop documentation</a> for an -overview of how to provide drag-and-drop in your application. -<p> <p>See also <a href="qtextdrag.html">TQTextDrag</a>, <a href="qimagedrag.html">TQImageDrag</a>, and <a href="qdropevent.html">TQDropEvent</a>. - -<p>Example: <a href="simple_dd-example.html#x2830">iconview/simple_dd/main.cpp</a>. -<h3 class=fn>void <a name="enabledChange"></a>TQWidget::enabledChange ( bool oldEnabled )<tt> [virtual protected]</tt> -</h3> - -<p> This virtual function is called from <a href="#setEnabled">setEnabled</a>(). <em>oldEnabled</em> -is the previous setting; you can get the new setting from -<a href="#isEnabled">isEnabled</a>(). -<p> Reimplement this function if your widget needs to know when it -becomes enabled or disabled. You will almost certainly need to -update the widget using <a href="#update">update</a>(). -<p> The default implementation repaints the visible part of the -widget. -<p> <p>See also <a href="#enabled-prop">enabled</a>, <a href="#enabled-prop">enabled</a>, <a href="#repaint">repaint</a>(), <a href="#update">update</a>(), and <a href="#clipRegion">clipRegion</a>(). - -<h3 class=fn>void <a name="enterEvent"></a>TQWidget::enterEvent ( <a href="qevent.html">TQEvent</a> * )<tt> [virtual protected]</tt> -</h3> -This event handler can be reimplemented in a subclass to receive -widget enter events. -<p> An event is sent to the widget when the mouse cursor enters the -widget. -<p> <p>See also <a href="#leaveEvent">leaveEvent</a>(), <a href="#mouseMoveEvent">mouseMoveEvent</a>(), and <a href="#event">event</a>(). - -<h3 class=fn>void <a name="erase"></a>TQWidget::erase ( int x, int y, int w, int h ) -</h3> -Erases the specified area <em>(x, y, w, h)</em> in the widget without -generating a <a href="#paintEvent">paint event</a>. -<p> If <em>w</em> is negative, it is replaced with <tt>width() - x</tt>. If <em>h</em> -is negative, it is replaced width <tt>height() - y</tt>. -<p> Child widgets are not affected. -<p> <p>See also <a href="#repaint">repaint</a>(). - -<h3 class=fn>void <a name="erase-2"></a>TQWidget::erase () -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This version erases the entire widget. - -<h3 class=fn>void <a name="erase-3"></a>TQWidget::erase ( const <a href="qrect.html">TQRect</a> & r ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Erases the specified area <em>r</em> in the widget without generating a -<a href="#paintEvent">paint event</a>. - -<h3 class=fn>void <a name="erase-4"></a>TQWidget::erase ( const <a href="qregion.html">TQRegion</a> & reg ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Erases the area defined by <em>reg</em>, without generating a <a href="#paintEvent">paint event</a>. -<p> Child widgets are not affected. - -<h3 class=fn>const <a href="qcolor.html">TQColor</a> & <a name="eraseColor"></a>TQWidget::eraseColor () const -</h3> - -<p> Returns the erase color of the widget. -<p> <p>See also <a href="#setEraseColor">setEraseColor</a>(), <a href="#setErasePixmap">setErasePixmap</a>(), and <a href="#backgroundColor">backgroundColor</a>(). - -<h3 class=fn>const <a href="qpixmap.html">TQPixmap</a> * <a name="erasePixmap"></a>TQWidget::erasePixmap () const -</h3> -Returns the widget's erase pixmap. -<p> <p>See also <a href="#setErasePixmap">setErasePixmap</a>() and <a href="#eraseColor">eraseColor</a>(). - -<h3 class=fn>bool <a name="event"></a>TQWidget::event ( <a href="qevent.html">TQEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This is the main event handler; it handles event <em>e</em>. You can -reimplement this function in a subclass, but we recommend using -one of the specialized event handlers instead. -<p> The main event handler first passes an event through all <a href="qobject.html#installEventFilter">event filters</a> that have been -installed. If none of the filters intercept the event, it calls -one of the specialized event handlers. -<p> Key press and release events are treated differently from other -events. <a href="#event">event</a>() checks for Tab and Shift+Tab and tries to move the -focus appropriately. If there is no widget to move the focus to -(or the key press is not Tab or Shift+Tab), event() calls -<a href="#keyPressEvent">keyPressEvent</a>(). -<p> This function returns TRUE if it is able to pass the event over to -someone (i.e. someone wanted the event); otherwise returns FALSE. -<p> <p>See also <a href="#closeEvent">closeEvent</a>(), <a href="#focusInEvent">focusInEvent</a>(), <a href="#focusOutEvent">focusOutEvent</a>(), <a href="#enterEvent">enterEvent</a>(), <a href="#keyPressEvent">keyPressEvent</a>(), <a href="#keyReleaseEvent">keyReleaseEvent</a>(), <a href="#leaveEvent">leaveEvent</a>(), <a href="#mouseDoubleClickEvent">mouseDoubleClickEvent</a>(), <a href="#mouseMoveEvent">mouseMoveEvent</a>(), <a href="#mousePressEvent">mousePressEvent</a>(), <a href="#mouseReleaseEvent">mouseReleaseEvent</a>(), <a href="#moveEvent">moveEvent</a>(), <a href="#paintEvent">paintEvent</a>(), <a href="#resizeEvent">resizeEvent</a>(), <a href="qobject.html#event">TQObject::event</a>(), and <a href="qobject.html#timerEvent">TQObject::timerEvent</a>(). - -<p>Reimplemented from <a href="qobject.html#event">TQObject</a>. -<h3 class=fn><a href="qwidget.html">TQWidget</a> * <a name="find"></a>TQWidget::find ( WId id )<tt> [static]</tt> -</h3> -Returns a pointer to the widget with window identifer/handle <em>id</em>. -<p> The window identifier type depends on the underlying window -system, see <a href="qwindowdefs-h.html">qwindowdefs.h</a> for the actual definition. If there -is no widget with this identifier, 0 is returned. - -<h3 class=fn><a href="qfocusdata.html">TQFocusData</a> * <a name="focusData"></a>TQWidget::focusData ()<tt> [protected]</tt> -</h3> -Returns the focus data for this widget's top-level widget. -<p> Focus data always belongs to the top-level widget. The focus data -list contains all the widgets in this top-level widget that can -accept focus, in tab order. An iterator points to the current -focus widget (<a href="#focusWidget">focusWidget</a>() returns a pointer to this widget). -<p> This information is useful for implementing advanced versions of -<a href="#focusNextPrevChild">focusNextPrevChild</a>(). - -<h3 class=fn>void <a name="focusInEvent"></a>TQWidget::focusInEvent ( <a href="qfocusevent.html">TQFocusEvent</a> * )<tt> [virtual protected]</tt> -</h3> -This event handler can be reimplemented in a subclass to receive -<a href="focus.html#keyboard-focus">keyboard focus</a> events (focus received) for the widget. -<p> A widget normally must <a href="#setFocusPolicy">setFocusPolicy</a>() to something other than -<a href="#FocusPolicy-enum">NoFocus</a> in order to receive focus events. (Note that the -application programmer can call <a href="#setFocus">setFocus</a>() on any widget, even -those that do not normally accept focus.) -<p> The default implementation updates the widget (except for toplevel -widgets that do not specify a <a href="#focusPolicy">focusPolicy</a>() ). It also calls -<a href="#setMicroFocusHint">setMicroFocusHint</a>(), hinting any system-specific input tools about -the focus of the user's attention. -<p> <p>See also <a href="#focusOutEvent">focusOutEvent</a>(), <a href="#focusPolicy-prop">focusPolicy</a>, <a href="#keyPressEvent">keyPressEvent</a>(), <a href="#keyReleaseEvent">keyReleaseEvent</a>(), <a href="#event">event</a>(), and <a href="qfocusevent.html">TQFocusEvent</a>. - -<h3 class=fn>bool <a name="focusNextPrevChild"></a>TQWidget::focusNextPrevChild ( bool next )<tt> [virtual protected]</tt> -</h3> -Finds a new widget to give the <a href="focus.html#keyboard-focus">keyboard focus</a> to, as appropriate -for Tab and Shift+Tab, and returns TRUE if is can find a new -widget and FALSE if it can't, -<p> If <em>next</em> is TRUE, this function searches "forwards", if <em>next</em> -is FALSE, it searches "backwards". -<p> Sometimes, you will want to reimplement this function. For -example, a web browser might reimplement it to move its "current -active link" forwards or backwards, and call -<a href="#focusNextPrevChild">TQWidget::focusNextPrevChild</a>() only when it reaches the last or -first link on the "page". -<p> Child widgets call <a href="#focusNextPrevChild">focusNextPrevChild</a>() on their parent widgets, -but only the top-level widget decides where to redirect focus. By -overriding this method for an object, you thus gain control of -focus traversal for all child widgets. -<p> <b>Warning:</b> <a href="qscrollview.html">TQScrollView</a> uses it own logic for this function, which -does the right thing in most cases. But if you are using a -TQScrollView and want complete control of the focus chain you'll -need to override <a href="#focusNextPrevChild">TQScrollView::focusNextPrevChild</a>() and your -top-level widgets' focusNextPrevChild() functions. -<p> <p>See also <a href="#focusData">focusData</a>(). - -<h3 class=fn>void <a name="focusOutEvent"></a>TQWidget::focusOutEvent ( <a href="qfocusevent.html">TQFocusEvent</a> * )<tt> [virtual protected]</tt> -</h3> -This event handler can be reimplemented in a subclass to receive -<a href="focus.html#keyboard-focus">keyboard focus</a> events (focus lost) for the widget. -<p> A widget normally must <a href="#setFocusPolicy">setFocusPolicy</a>() to something other than -<a href="#FocusPolicy-enum">NoFocus</a> in order to receive focus events. (Note that the -application programmer can call <a href="#setFocus">setFocus</a>() on any widget, even -those that do not normally accept focus.) -<p> The default implementation updates the widget (except for toplevel -widgets that do not specify a <a href="#focusPolicy">focusPolicy</a>() ). It also calls -<a href="#setMicroFocusHint">setMicroFocusHint</a>(), hinting any system-specific input tools about -the focus of the user's attention. -<p> <p>See also <a href="#focusInEvent">focusInEvent</a>(), <a href="#focusPolicy-prop">focusPolicy</a>, <a href="#keyPressEvent">keyPressEvent</a>(), <a href="#keyReleaseEvent">keyReleaseEvent</a>(), <a href="#event">event</a>(), and <a href="qfocusevent.html">TQFocusEvent</a>. - -<p>Example: <a href="qmag-example.html#x1796">qmag/qmag.cpp</a>. -<h3 class=fn><a href="qwidget.html#FocusPolicy-enum">FocusPolicy</a> <a name="focusPolicy"></a>TQWidget::focusPolicy () const -</h3><p>Returns the way the widget accepts keyboard focus. -See the <a href="qwidget.html#focusPolicy-prop">"focusPolicy"</a> property for details. -<h3 class=fn><a href="qwidget.html">TQWidget</a> * <a name="focusProxy"></a>TQWidget::focusProxy () const -</h3> -Returns the focus proxy, or 0 if there is no focus proxy. -<p> <p>See also <a href="#setFocusProxy">setFocusProxy</a>(). - -<h3 class=fn><a href="qwidget.html">TQWidget</a> * <a name="focusWidget"></a>TQWidget::focusWidget () const -</h3> -Returns the focus widget in this widget's window. This is not the -same as <a href="qapplication.html#focusWidget">TQApplication::focusWidget</a>(), which returns the focus -widget in the currently active window. - -<h3 class=fn><a href="qfont.html">TQFont</a> <a name="font"></a>TQWidget::font () const -</h3><p>Returns the font currently set for the widget. -See the <a href="qwidget.html#font-prop">"font"</a> property for details. -<h3 class=fn>void <a name="fontChange"></a>TQWidget::fontChange ( const <a href="qfont.html">TQFont</a> & oldFont )<tt> [virtual protected]</tt> -</h3> - -<p> This virtual function is called from <a href="#setFont">setFont</a>(). <em>oldFont</em> is the -previous font; you can get the new font from <a href="#font">font</a>(). -<p> Reimplement this function if your widget needs to know when its -font changes. You will almost certainly need to update the widget -using <a href="#update">update</a>(). -<p> The default implementation updates the widget including its -geometry. -<p> <p>See also <a href="#font-prop">font</a>, <a href="#font-prop">font</a>, <a href="#update">update</a>(), and <a href="#updateGeometry">updateGeometry</a>(). - -<h3 class=fn><a href="qfontinfo.html">TQFontInfo</a> <a name="fontInfo"></a>TQWidget::fontInfo () const -</h3> - -<p> Returns the font info for the widget's current font. -Equivalent to TQFontInto(widget->font()). -<p> <p>See also <a href="#font-prop">font</a>, <a href="#fontMetrics">fontMetrics</a>(), and <a href="#font-prop">font</a>. - -<h3 class=fn><a href="qfontmetrics.html">TQFontMetrics</a> <a name="fontMetrics"></a>TQWidget::fontMetrics () const -</h3> - -<p> Returns the font metrics for the widget's current font. -Equivalent to <a href="qfontmetrics.html">TQFontMetrics</a>(widget->font()). -<p> <p>See also <a href="#font-prop">font</a>, <a href="#fontInfo">fontInfo</a>(), and <a href="#font-prop">font</a>. - -<p>Examples: <a href="drawdemo-example.html#x1084">drawdemo/drawdemo.cpp</a> and <a href="qmag-example.html#x1797">qmag/qmag.cpp</a>. -<h3 class=fn>const <a href="qcolor.html">TQColor</a> & <a name="foregroundColor"></a>TQWidget::foregroundColor () const -</h3> -Same as <a href="#paletteForegroundColor">paletteForegroundColor</a>() - -<h3 class=fn><a href="qrect.html">TQRect</a> <a name="frameGeometry"></a>TQWidget::frameGeometry () const -</h3><p>Returns geometry of the widget relative to its parent including any window frame. -See the <a href="qwidget.html#frameGeometry-prop">"frameGeometry"</a> property for details. -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="frameSize"></a>TQWidget::frameSize () const -</h3><p>Returns the size of the widget including any window frame. -See the <a href="qwidget.html#frameSize-prop">"frameSize"</a> property for details. -<h3 class=fn>const <a href="qrect.html">TQRect</a> & <a name="geometry"></a>TQWidget::geometry () const -</h3><p>Returns the geometry of the widget relative to its parent and excluding the window frame. -See the <a href="qwidget.html#geometry-prop">"geometry"</a> property for details. -<h3 class=fn>WFlags <a name="getWFlags"></a>TQWidget::getWFlags () const<tt> [protected]</tt> -</h3> - -<p> Returns the widget flags for this this widget. -<p> Widget flags are a combination of <a href="qt.html#WidgetFlags-enum">TQt::WidgetFlags</a>. -<p> <p>See also <a href="#testWFlags">testWFlags</a>(), <a href="#setWFlags">setWFlags</a>(), and <a href="#clearWFlags">clearWFlags</a>(). - -<h3 class=fn>void <a name="grabKeyboard"></a>TQWidget::grabKeyboard () -</h3> -Grabs the keyboard input. -<p> This widget reveives all keyboard events until <a href="#releaseKeyboard">releaseKeyboard</a>() -is called; other widgets get no keyboard events at all. Mouse -events are not affected. Use <a href="#grabMouse">grabMouse</a>() if you want to grab that. -<p> The focus widget is not affected, except that it doesn't receive -any keyboard events. <a href="#setFocus">setFocus</a>() moves the focus as usual, but the -new focus widget receives keyboard events only after -releaseKeyboard() is called. -<p> If a different widget is currently grabbing keyboard input, that -widget's grab is released first. -<p> <p>See also <a href="#releaseKeyboard">releaseKeyboard</a>(), <a href="#grabMouse">grabMouse</a>(), <a href="#releaseMouse">releaseMouse</a>(), and <a href="#focusWidget">focusWidget</a>(). - -<h3 class=fn>void <a name="grabMouse"></a>TQWidget::grabMouse () -</h3> -Grabs the mouse input. -<p> This widget receives all mouse events until <a href="#releaseMouse">releaseMouse</a>() is -called; other widgets get no mouse events at all. Keyboard -events are not affected. Use <a href="#grabKeyboard">grabKeyboard</a>() if you want to grab -that. -<p> <b>Warning:</b> Bugs in mouse-grabbing applications very often lock the -terminal. Use this function with extreme caution, and consider -using the <tt>-nograb</tt> command line option while debugging. -<p> It is almost never necessary to grab the mouse when using TQt, as -TQt grabs and releases it sensibly. In particular, TQt grabs the -mouse when a mouse button is pressed and keeps it until the last -button is released. -<p> Note that only visible widgets can grab mouse input. If -<a href="#isVisible">isVisible</a>() returns FALSE for a widget, that widget cannot call -<a href="#grabMouse">grabMouse</a>(). -<p> <p>See also <a href="#releaseMouse">releaseMouse</a>(), <a href="#grabKeyboard">grabKeyboard</a>(), <a href="#releaseKeyboard">releaseKeyboard</a>(), <a href="#grabKeyboard">grabKeyboard</a>(), and <a href="#focusWidget">focusWidget</a>(). - -<h3 class=fn>void <a name="grabMouse-2"></a>TQWidget::grabMouse ( const <a href="qcursor.html">TQCursor</a> & cursor ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Grabs the mouse input and changes the cursor shape. -<p> The cursor will assume shape <em>cursor</em> (for as long as the mouse -focus is grabbed) and this widget will be the only one to receive -mouse events until <a href="#releaseMouse">releaseMouse</a>() is called(). -<p> <b>Warning:</b> Grabbing the mouse might lock the terminal. -<p> <p>See also <a href="#releaseMouse">releaseMouse</a>(), <a href="#grabKeyboard">grabKeyboard</a>(), <a href="#releaseKeyboard">releaseKeyboard</a>(), and <a href="#cursor-prop">cursor</a>. - -<h3 class=fn>bool <a name="hasFocus"></a>TQWidget::hasFocus () const -</h3><p>Returns TRUE if this widget (or its focus proxy) has the keyboard input focus; otherwise returns FALSE. -See the <a href="qwidget.html#focus-prop">"focus"</a> property for details. -<h3 class=fn>bool <a name="hasMouse"></a>TQWidget::hasMouse () const -</h3><p>Returns TRUE if the widget is under the mouse cursor; otherwise returns FALSE. -See the <a href="qwidget.html#underMouse-prop">"underMouse"</a> property for details. -<h3 class=fn>bool <a name="hasMouseTracking"></a>TQWidget::hasMouseTracking () const -</h3><p>Returns TRUE if mouse tracking is enabled for the widget; otherwise returns FALSE. -See the <a href="qwidget.html#mouseTracking-prop">"mouseTracking"</a> property for details. -<h3 class=fn>int <a name="height"></a>TQWidget::height () const -</h3><p>Returns the height of the widget excluding any window frame. -See the <a href="qwidget.html#height-prop">"height"</a> property for details. -<h3 class=fn>int <a name="heightForWidth"></a>TQWidget::heightForWidth ( int w ) const<tt> [virtual]</tt> -</h3> -Returns the preferred height for this widget, given the width <em>w</em>. The default implementation returns 0, indicating that the -preferred height does not depend on the width. -<p> <b>Warning:</b> Does not look at the widget's layout. - -<p>Reimplemented in <a href="qmenubar.html#heightForWidth">TQMenuBar</a> and <a href="qtextedit.html#heightForWidth">TQTextEdit</a>. -<h3 class=fn>void <a name="hide"></a>TQWidget::hide ()<tt> [virtual slot]</tt> -</h3> -Hides the widget. -<p> You almost never have to reimplement this function. If you need to -do something after a widget is hidden, use <a href="#hideEvent">hideEvent</a>() instead. -<p> <p>See also <a href="#hideEvent">hideEvent</a>(), <a href="#hidden-prop">hidden</a>, <a href="#show">show</a>(), <a href="#showMinimized">showMinimized</a>(), <a href="#visible-prop">visible</a>, and <a href="#close">close</a>(). - -<p>Examples: <a href="mdi-example.html#x2079">mdi/application.cpp</a>, <a href="popup-example.html#x1619">popup/popup.cpp</a>, <a href="progress-example.html#x89">progress/progress.cpp</a>, <a href="scrollview-example.html#x658">scrollview/scrollview.cpp</a>, <a href="qaxcontainer-example-webbrowser.html#x2516">webbrowser/mainwindow.ui.h</a>, and <a href="xform-example.html#x1267">xform/xform.cpp</a>. -<p>Reimplemented in <a href="qmenubar.html#hide">TQMenuBar</a>. -<h3 class=fn>void <a name="hideEvent"></a>TQWidget::hideEvent ( <a href="qhideevent.html">TQHideEvent</a> * )<tt> [virtual protected]</tt> -</h3> -This event handler can be reimplemented in a subclass to receive -widget hide events. -<p> Hide events are sent to widgets immediately after they have been -hidden. -<p> <p>See also <a href="#event">event</a>() and <a href="qhideevent.html">TQHideEvent</a>. - -<p>Reimplemented in <a href="qscrollbar.html#hideEvent">TQScrollBar</a>. -<h3 class=fn>const <a href="qpixmap.html">TQPixmap</a> * <a name="icon"></a>TQWidget::icon () const -</h3><p>Returns the widget's icon. -See the <a href="qwidget.html#icon-prop">"icon"</a> property for details. -<h3 class=fn><a href="qstring.html">TQString</a> <a name="iconText"></a>TQWidget::iconText () const -</h3><p>Returns the widget's icon text. -See the <a href="qwidget.html#iconText-prop">"iconText"</a> property for details. -<h3 class=fn>void <a name="iconify"></a>TQWidget::iconify ()<tt> [slot]</tt> -</h3> -<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -<p> -<h3 class=fn>void <a name="imComposeEvent"></a>TQWidget::imComposeEvent ( <a href="qimevent.html">TQIMEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler, for event <em>e</em>, can be reimplemented in a -subclass to receive Input Method composition events. This handler -is called when the user has entered some text using an Input Method. -<p> The default implementation calls e->ignore(), which rejects the -Input Method event. See the <a href="qimevent.html">TQIMEvent</a> documentation for more -details. -<p> <p>See also <a href="#event">event</a>() and <a href="qimevent.html">TQIMEvent</a>. - -<h3 class=fn>void <a name="imEndEvent"></a>TQWidget::imEndEvent ( <a href="qimevent.html">TQIMEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler, for event <em>e</em>, can be reimplemented in a -subclass to receive Input Method composition events. This handler -is called when the user has finished inputting text via an Input -Method. -<p> The default implementation calls e->ignore(), which rejects the -Input Method event. See the <a href="qimevent.html">TQIMEvent</a> documentation for more -details. -<p> <p>See also <a href="#event">event</a>() and <a href="qimevent.html">TQIMEvent</a>. - -<h3 class=fn>void <a name="imStartEvent"></a>TQWidget::imStartEvent ( <a href="qimevent.html">TQIMEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler, for event <em>e</em>, can be reimplemented in a -subclass to receive Input Method composition events. This handler -is called when the user begins entering text using an Input Method. -<p> The default implementation calls e->ignore(), which rejects the -Input Method event. See the <a href="qimevent.html">TQIMEvent</a> documentation for more -details. -<p> <p>See also <a href="#event">event</a>() and <a href="qimevent.html">TQIMEvent</a>. - -<h3 class=fn>bool <a name="isActiveWindow"></a>TQWidget::isActiveWindow () const -</h3><p>Returns TRUE if this widget is the active window; otherwise returns FALSE. -See the <a href="qwidget.html#isActiveWindow-prop">"isActiveWindow"</a> property for details. -<h3 class=fn>bool <a name="isDesktop"></a>TQWidget::isDesktop () const -</h3><p>Returns TRUE if the widget is a desktop widget, i.e. represents the desktop; otherwise returns FALSE. -See the <a href="qwidget.html#isDesktop-prop">"isDesktop"</a> property for details. -<h3 class=fn>bool <a name="isDialog"></a>TQWidget::isDialog () const -</h3><p>Returns TRUE if the widget is a dialog widget; otherwise returns FALSE. -See the <a href="qwidget.html#isDialog-prop">"isDialog"</a> property for details. -<h3 class=fn>bool <a name="isEnabled"></a>TQWidget::isEnabled () const -</h3><p>Returns TRUE if the widget is enabled; otherwise returns FALSE. -See the <a href="qwidget.html#enabled-prop">"enabled"</a> property for details. -<h3 class=fn>bool <a name="isEnabledTo"></a>TQWidget::isEnabledTo ( <a href="qwidget.html">TQWidget</a> * ancestor ) const -</h3> -Returns TRUE if this widget would become enabled if <em>ancestor</em> is -enabled; otherwise returns FALSE. -<p> This is the case if neither the widget itself nor every parent up -to but excluding <em>ancestor</em> has been explicitly disabled. -<p> <a href="#isEnabledTo">isEnabledTo</a>(0) is equivalent to <a href="#isEnabled">isEnabled</a>(). -<p> <p>See also <a href="#enabled-prop">enabled</a> and <a href="#enabled-prop">enabled</a>. - -<h3 class=fn>bool <a name="isEnabledToTLW"></a>TQWidget::isEnabledToTLW () const -</h3> - -<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -<p> This function is deprecated. It is equivalent to <a href="#isEnabled">isEnabled</a>() - -<h3 class=fn>bool <a name="isFocusEnabled"></a>TQWidget::isFocusEnabled () const -</h3><p>Returns TRUE if the widget accepts keyboard focus; otherwise returns FALSE. -See the <a href="qwidget.html#focusEnabled-prop">"focusEnabled"</a> property for details. -<h3 class=fn>bool <a name="isFullScreen"></a>TQWidget::isFullScreen () const -</h3><p>Returns TRUE if the widget is full screen; otherwise returns FALSE. -See the <a href="qwidget.html#fullScreen-prop">"fullScreen"</a> property for details. -<h3 class=fn>bool <a name="isHidden"></a>TQWidget::isHidden () const -</h3><p>Returns TRUE if the widget is explicitly hidden; otherwise returns FALSE. -See the <a href="qwidget.html#hidden-prop">"hidden"</a> property for details. -<h3 class=fn>bool <a name="isInputMethodEnabled"></a>TQWidget::isInputMethodEnabled () const -</h3><p>Returns enables or disables the use of input methods for this widget. -See the <a href="qwidget.html#inputMethodEnabled-prop">"inputMethodEnabled"</a> property for details. -<h3 class=fn>bool <a name="isMaximized"></a>TQWidget::isMaximized () const -</h3><p>Returns TRUE if this widget is maximized; otherwise returns FALSE. -See the <a href="qwidget.html#maximized-prop">"maximized"</a> property for details. -<h3 class=fn>bool <a name="isMinimized"></a>TQWidget::isMinimized () const -</h3><p>Returns TRUE if this widget is minimized (iconified); otherwise returns FALSE. -See the <a href="qwidget.html#minimized-prop">"minimized"</a> property for details. -<h3 class=fn>bool <a name="isModal"></a>TQWidget::isModal () const -</h3><p>Returns TRUE if the widget is a modal widget; otherwise returns FALSE. -See the <a href="qwidget.html#isModal-prop">"isModal"</a> property for details. -<h3 class=fn>bool <a name="isPopup"></a>TQWidget::isPopup () const -</h3><p>Returns TRUE if the widget is a popup widget; otherwise returns FALSE. -See the <a href="qwidget.html#isPopup-prop">"isPopup"</a> property for details. -<h3 class=fn>bool <a name="isShown"></a>TQWidget::isShown () const -</h3><p>Returns TRUE if the widget is shown; otherwise returns FALSE. -See the <a href="qwidget.html#shown-prop">"shown"</a> property for details. -<h3 class=fn>bool <a name="isTopLevel"></a>TQWidget::isTopLevel () const -</h3><p>Returns TRUE if the widget is a top-level widget; otherwise returns FALSE. -See the <a href="qwidget.html#isTopLevel-prop">"isTopLevel"</a> property for details. -<h3 class=fn>bool <a name="isUpdatesEnabled"></a>TQWidget::isUpdatesEnabled () const -</h3><p>Returns TRUE if updates are enabled; otherwise returns FALSE. -See the <a href="qwidget.html#updatesEnabled-prop">"updatesEnabled"</a> property for details. -<h3 class=fn>bool <a name="isVisible"></a>TQWidget::isVisible () const -</h3><p>Returns TRUE if the widget is visible; otherwise returns FALSE. -See the <a href="qwidget.html#visible-prop">"visible"</a> property for details. -<h3 class=fn>bool <a name="isVisibleTo"></a>TQWidget::isVisibleTo ( <a href="qwidget.html">TQWidget</a> * ancestor ) const -</h3> -Returns TRUE if this widget would become visible if <em>ancestor</em> is -shown; otherwise returns FALSE. -<p> The TRUE case occurs if neither the widget itself nor any parent -up to but excluding <em>ancestor</em> has been explicitly hidden. -<p> This function will still return TRUE if the widget is obscured by -other windows on the screen, but could be physically visible if it -or they were to be moved. -<p> <a href="#isVisibleTo">isVisibleTo</a>(0) is identical to <a href="#isVisible">isVisible</a>(). -<p> <p>See also <a href="#show">show</a>(), <a href="#hide">hide</a>(), and <a href="#visible-prop">visible</a>. - -<h3 class=fn>bool <a name="isVisibleToTLW"></a>TQWidget::isVisibleToTLW () const -</h3> - -<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -<p> This function is deprecated. It is equivalent to <a href="#isVisible">isVisible</a>() - -<h3 class=fn>void <a name="keyPressEvent"></a>TQWidget::keyPressEvent ( <a href="qkeyevent.html">TQKeyEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler, for event <em>e</em>, can be reimplemented in a -subclass to receive key press events for the widget. -<p> A widget must call <a href="#setFocusPolicy">setFocusPolicy</a>() to accept focus initially and -have focus in order to receive a key press event. -<p> If you reimplement this handler, it is very important that you -explicitly <a href="qkeyevent.html#ignore">ignore</a> the event -if you do not understand it, so that the widget's parent can -interpret it; otherwise, the event will be implicitly accepted. -Although top-level widgets are able to choose whether to accept -or ignore unknown events because they have no parent widgets that -could otherwise handle them, it is good practice to explicitly -ignore events to make widgets as reusable as possible. -<p> The default implementation closes popup widgets if the user -presses <b>Esc</b>. Otherwise the event is ignored. -<p> <p>See also <a href="#keyReleaseEvent">keyReleaseEvent</a>(), <a href="qkeyevent.html#ignore">TQKeyEvent::ignore</a>(), <a href="#focusPolicy-prop">focusPolicy</a>, <a href="#focusInEvent">focusInEvent</a>(), <a href="#focusOutEvent">focusOutEvent</a>(), <a href="#event">event</a>(), and <a href="qkeyevent.html">TQKeyEvent</a>. - -<p>Example: <a href="picture-example.html#x127">picture/picture.cpp</a>. -<p>Reimplemented in <a href="qlineedit.html#keyPressEvent">TQLineEdit</a> and <a href="qtextedit.html#keyPressEvent">TQTextEdit</a>. -<h3 class=fn>void <a name="keyReleaseEvent"></a>TQWidget::keyReleaseEvent ( <a href="qkeyevent.html">TQKeyEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler, for event <em>e</em>, can be reimplemented in a -subclass to receive key release events for the widget. -<p> A widget must <a href="#setFocusPolicy">accept focus</a> -initially and <a href="#hasFocus">have focus</a> in order to -receive a key release event. -<p> If you reimplement this handler, it is very important that you -<a href="qkeyevent.html">ignore()</a> the release if you do not -understand it, so that the widget's parent can interpret it. -<p> The default implementation ignores the event. -<p> <p>See also <a href="#keyPressEvent">keyPressEvent</a>(), <a href="qkeyevent.html#ignore">TQKeyEvent::ignore</a>(), <a href="#focusPolicy-prop">focusPolicy</a>, <a href="#focusInEvent">focusInEvent</a>(), <a href="#focusOutEvent">focusOutEvent</a>(), <a href="#event">event</a>(), and <a href="qkeyevent.html">TQKeyEvent</a>. - -<h3 class=fn><a href="qwidget.html">TQWidget</a> * <a name="keyboardGrabber"></a>TQWidget::keyboardGrabber ()<tt> [static]</tt> -</h3> -Returns the widget that is currently grabbing the keyboard input. -<p> If no widget in this application is currently grabbing the -keyboard, 0 is returned. -<p> <p>See also <a href="#grabMouse">grabMouse</a>() and <a href="#mouseGrabber">mouseGrabber</a>(). - -<h3 class=fn><a href="qlayout.html">TQLayout</a> * <a name="layout"></a>TQWidget::layout () const -</h3> - -<p> Returns the layout engine that manages the geometry of this -widget's children. -<p> If the widget does not have a layout, <a href="#layout">layout</a>() returns 0. -<p> <p>See also <a href="#sizePolicy-prop">sizePolicy</a>. - -<p>Examples: <a href="tutorial2-09.html#x2647">chart/optionsform.cpp</a> and <a href="simple-font-demo-example.html#x2858">fonts/simple-qfont-demo/viewer.cpp</a>. -<h3 class=fn>void <a name="leaveEvent"></a>TQWidget::leaveEvent ( <a href="qevent.html">TQEvent</a> * )<tt> [virtual protected]</tt> -</h3> -This event handler can be reimplemented in a subclass to receive -widget leave events. -<p> A leave event is sent to the widget when the mouse cursor leaves -the widget. -<p> <p>See also <a href="#enterEvent">enterEvent</a>(), <a href="#mouseMoveEvent">mouseMoveEvent</a>(), and <a href="#event">event</a>(). - -<h3 class=fn>void <a name="lower"></a>TQWidget::lower ()<tt> [slot]</tt> -</h3> -Lowers the widget to the bottom of the parent widget's stack. -<p> After this call the widget will be visually behind (and therefore -obscured by) any overlapping sibling widgets. -<p> <p>See also <a href="#raise">raise</a>() and <a href="#stackUnder">stackUnder</a>(). - -<h3 class=fn>bool <a name="macEvent"></a>TQWidget::macEvent ( MSG * )<tt> [virtual protected]</tt> -</h3> -This special event handler can be reimplemented in a subclass to -receive native Macintosh events. -<p> In your reimplementation of this function, if you want to stop the -event being handled by TQt, return TRUE. If you return FALSE, this -native event is passed back to TQt, which translates the event into -a TQt event and sends it to the widget. -<p> <b>Warning:</b> This function is not portable. -<p> <p>See also <a href="qapplication.html#macEventFilter">TQApplication::macEventFilter</a>(). - -<h3 class=fn><a href="qpoint.html">TQPoint</a> <a name="mapFrom"></a>TQWidget::mapFrom ( <a href="qwidget.html">TQWidget</a> * parent, const <a href="qpoint.html">TQPoint</a> & pos ) const -</h3> -Translates the widget coordinate <em>pos</em> from the coordinate system -of <em>parent</em> to this widget's coordinate system. The <em>parent</em> -must not be 0 and must be a parent of the calling widget. -<p> <p>See also <a href="#mapTo">mapTo</a>(), <a href="#mapFromParent">mapFromParent</a>(), <a href="#mapFromGlobal">mapFromGlobal</a>(), and <a href="#underMouse-prop">underMouse</a>. - -<h3 class=fn><a href="qpoint.html">TQPoint</a> <a name="mapFromGlobal"></a>TQWidget::mapFromGlobal ( const <a href="qpoint.html">TQPoint</a> & pos ) const -</h3> -Translates the global screen coordinate <em>pos</em> to widget -coordinates. -<p> <p>See also <a href="#mapToGlobal">mapToGlobal</a>(), <a href="#mapFrom">mapFrom</a>(), and <a href="#mapFromParent">mapFromParent</a>(). - -<h3 class=fn><a href="qpoint.html">TQPoint</a> <a name="mapFromParent"></a>TQWidget::mapFromParent ( const <a href="qpoint.html">TQPoint</a> & pos ) const -</h3> -Translates the parent widget coordinate <em>pos</em> to widget -coordinates. -<p> Same as <a href="#mapFromGlobal">mapFromGlobal</a>() if the widget has no parent. -<p> <p>See also <a href="#mapToParent">mapToParent</a>(), <a href="#mapFrom">mapFrom</a>(), <a href="#mapFromGlobal">mapFromGlobal</a>(), and <a href="#underMouse-prop">underMouse</a>. - -<h3 class=fn><a href="qpoint.html">TQPoint</a> <a name="mapTo"></a>TQWidget::mapTo ( <a href="qwidget.html">TQWidget</a> * parent, const <a href="qpoint.html">TQPoint</a> & pos ) const -</h3> -Translates the widget coordinate <em>pos</em> to the coordinate system -of <em>parent</em>. The <em>parent</em> must not be 0 and must be a parent -of the calling widget. -<p> <p>See also <a href="#mapFrom">mapFrom</a>(), <a href="#mapToParent">mapToParent</a>(), <a href="#mapToGlobal">mapToGlobal</a>(), and <a href="#underMouse-prop">underMouse</a>. - -<h3 class=fn><a href="qpoint.html">TQPoint</a> <a name="mapToGlobal"></a>TQWidget::mapToGlobal ( const <a href="qpoint.html">TQPoint</a> & pos ) const -</h3> -Translates the widget coordinate <em>pos</em> to global screen -coordinates. For example, <tt>mapToGlobal(TQPoint(0,0))</tt> would give -the global coordinates of the top-left pixel of the widget. -<p> <p>See also <a href="#mapFromGlobal">mapFromGlobal</a>(), <a href="#mapTo">mapTo</a>(), and <a href="#mapToParent">mapToParent</a>(). - -<p>Example: <a href="scribble-example.html#x947">scribble/scribble.cpp</a>. -<h3 class=fn><a href="qpoint.html">TQPoint</a> <a name="mapToParent"></a>TQWidget::mapToParent ( const <a href="qpoint.html">TQPoint</a> & pos ) const -</h3> -Translates the widget coordinate <em>pos</em> to a coordinate in the -parent widget. -<p> Same as <a href="#mapToGlobal">mapToGlobal</a>() if the widget has no parent. -<p> <p>See also <a href="#mapFromParent">mapFromParent</a>(), <a href="#mapTo">mapTo</a>(), <a href="#mapToGlobal">mapToGlobal</a>(), and <a href="#underMouse-prop">underMouse</a>. - -<h3 class=fn>int <a name="maximumHeight"></a>TQWidget::maximumHeight () const -</h3><p>Returns the widget's maximum height. -See the <a href="qwidget.html#maximumHeight-prop">"maximumHeight"</a> property for details. -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="maximumSize"></a>TQWidget::maximumSize () const -</h3><p>Returns the widget's maximum size. -See the <a href="qwidget.html#maximumSize-prop">"maximumSize"</a> property for details. -<h3 class=fn>int <a name="maximumWidth"></a>TQWidget::maximumWidth () const -</h3><p>Returns the widget's maximum width. -See the <a href="qwidget.html#maximumWidth-prop">"maximumWidth"</a> property for details. -<h3 class=fn>int <a name="metric"></a>TQWidget::metric ( int m ) const<tt> [virtual protected]</tt> -</h3> -Internal implementation of the virtual TQPaintDevice::metric() -function. -<p> Use the <a href="qpaintdevicemetrics.html">TQPaintDeviceMetrics</a> class instead. -<p> <em>m</em> is the metric to get. - -<h3 class=fn><a href="qrect.html">TQRect</a> <a name="microFocusHint"></a>TQWidget::microFocusHint () const -</h3><p>Returns the currently set micro focus hint for this widget. -See the <a href="qwidget.html#microFocusHint-prop">"microFocusHint"</a> property for details. -<h3 class=fn>int <a name="minimumHeight"></a>TQWidget::minimumHeight () const -</h3><p>Returns the widget's minimum height. -See the <a href="qwidget.html#minimumHeight-prop">"minimumHeight"</a> property for details. -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="minimumSize"></a>TQWidget::minimumSize () const -</h3><p>Returns the widget's minimum size. -See the <a href="qwidget.html#minimumSize-prop">"minimumSize"</a> property for details. -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="minimumSizeHint"></a>TQWidget::minimumSizeHint () const<tt> [virtual]</tt> -</h3><p>Returns the recommended minimum size for the widget. -See the <a href="qwidget.html#minimumSizeHint-prop">"minimumSizeHint"</a> property for details. -<p>Reimplemented in <a href="qlineedit.html#minimumSizeHint">TQLineEdit</a>. -<h3 class=fn>int <a name="minimumWidth"></a>TQWidget::minimumWidth () const -</h3><p>Returns the widget's minimum width. -See the <a href="qwidget.html#minimumWidth-prop">"minimumWidth"</a> property for details. -<h3 class=fn>void <a name="mouseDoubleClickEvent"></a>TQWidget::mouseDoubleClickEvent ( <a href="qmouseevent.html">TQMouseEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler, for event <em>e</em>, can be reimplemented in a -subclass to receive mouse double click events for the widget. -<p> The default implementation generates a normal mouse press event. -<p> Note that the widgets gets a <a href="#mousePressEvent">mousePressEvent</a>() and a -<a href="#mouseReleaseEvent">mouseReleaseEvent</a>() before the <a href="#mouseDoubleClickEvent">mouseDoubleClickEvent</a>(). -<p> <p>See also <a href="#mousePressEvent">mousePressEvent</a>(), <a href="#mouseReleaseEvent">mouseReleaseEvent</a>(), <a href="#mouseMoveEvent">mouseMoveEvent</a>(), <a href="#event">event</a>(), and <a href="qmouseevent.html">TQMouseEvent</a>. - -<h3 class=fn><a href="qwidget.html">TQWidget</a> * <a name="mouseGrabber"></a>TQWidget::mouseGrabber ()<tt> [static]</tt> -</h3> -Returns the widget that is currently grabbing the mouse input. -<p> If no widget in this application is currently grabbing the mouse, -0 is returned. -<p> <p>See also <a href="#grabMouse">grabMouse</a>() and <a href="#keyboardGrabber">keyboardGrabber</a>(). - -<h3 class=fn>void <a name="mouseMoveEvent"></a>TQWidget::mouseMoveEvent ( <a href="qmouseevent.html">TQMouseEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler, for event <em>e</em>, can be reimplemented in a -subclass to receive mouse move events for the widget. -<p> If mouse tracking is switched off, mouse move events only occur if -a mouse button is pressed while the mouse is being moved. If mouse -tracking is switched on, mouse move events occur even if no mouse -button is pressed. -<p> <a href="qmouseevent.html#pos">TQMouseEvent::pos</a>() reports the position of the mouse cursor, -relative to this widget. For press and release events, the -position is usually the same as the position of the last mouse -move event, but it might be different if the user's hand shakes. -This is a feature of the underlying window system, not TQt. -<p> <p>See also <a href="#mouseTracking-prop">mouseTracking</a>, <a href="#mousePressEvent">mousePressEvent</a>(), <a href="#mouseReleaseEvent">mouseReleaseEvent</a>(), <a href="#mouseDoubleClickEvent">mouseDoubleClickEvent</a>(), <a href="#event">event</a>(), and <a href="qmouseevent.html">TQMouseEvent</a>. - -<p>Examples: <a href="aclock-example.html#x1206">aclock/aclock.cpp</a>, <a href="drawlines-example.html#x1658">drawlines/connect.cpp</a>, <a href="simple_dd-example.html#x2831">iconview/simple_dd/main.cpp</a>, <a href="life-example.html#x1896">life/life.cpp</a>, <a href="popup-example.html#x1620">popup/popup.cpp</a>, <a href="qmag-example.html#x1800">qmag/qmag.cpp</a>, and <a href="scribble-example.html#x948">scribble/scribble.cpp</a>. -<p>Reimplemented in <a href="qsizegrip.html#mouseMoveEvent">TQSizeGrip</a>. -<h3 class=fn>void <a name="mousePressEvent"></a>TQWidget::mousePressEvent ( <a href="qmouseevent.html">TQMouseEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler, for event <em>e</em>, can be reimplemented in a -subclass to receive mouse press events for the widget. -<p> If you create new widgets in the <a href="#mousePressEvent">mousePressEvent</a>() the -<a href="#mouseReleaseEvent">mouseReleaseEvent</a>() may not end up where you expect, depending on -the underlying window system (or X11 window manager), the widgets' -location and maybe more. -<p> The default implementation implements the closing of popup widgets -when you click outside the window. For other widget types it does -nothing. -<p> <p>See also <a href="#mouseReleaseEvent">mouseReleaseEvent</a>(), <a href="#mouseDoubleClickEvent">mouseDoubleClickEvent</a>(), <a href="#mouseMoveEvent">mouseMoveEvent</a>(), <a href="#event">event</a>(), and <a href="qmouseevent.html">TQMouseEvent</a>. - -<p>Examples: <a href="biff-example.html#x1960">biff/biff.cpp</a>, <a href="drawlines-example.html#x1659">drawlines/connect.cpp</a>, <a href="simple_dd-example.html#x2832">iconview/simple_dd/main.cpp</a>, <a href="life-example.html#x1897">life/life.cpp</a>, <a href="qmag-example.html#x1801">qmag/qmag.cpp</a>, <a href="scribble-example.html#x949">scribble/scribble.cpp</a>, and <a href="tooltip-example.html#x452">tooltip/tooltip.cpp</a>. -<p>Reimplemented in <a href="qsizegrip.html#mousePressEvent">TQSizeGrip</a>. -<h3 class=fn>void <a name="mouseReleaseEvent"></a>TQWidget::mouseReleaseEvent ( <a href="qmouseevent.html">TQMouseEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler, for event <em>e</em>, can be reimplemented in a -subclass to receive mouse release events for the widget. -<p> <p>See also <a href="#mouseDoubleClickEvent">mouseDoubleClickEvent</a>(), <a href="#mouseMoveEvent">mouseMoveEvent</a>(), <a href="#event">event</a>(), and <a href="qmouseevent.html">TQMouseEvent</a>. - -<p>Examples: <a href="drawlines-example.html#x1660">drawlines/connect.cpp</a>, <a href="hello-example.html#x1641">hello/hello.cpp</a>, <a href="popup-example.html#x1621">popup/popup.cpp</a>, <a href="qmag-example.html#x1802">qmag/qmag.cpp</a>, <a href="scribble-example.html#x950">scribble/scribble.cpp</a>, <a href="showimg-example.html#x1350">showimg/showimg.cpp</a>, and <a href="tutorial1-14.html#x2432">t14/cannon.cpp</a>. -<h3 class=fn>void <a name="move"></a>TQWidget::move ( const <a href="qpoint.html">TQPoint</a> & )<tt> [slot]</tt> -</h3><p>Sets the position of the widget within its parent widget. -See the <a href="qwidget.html#pos-prop">"pos"</a> property for details. -<h3 class=fn>void <a name="move-2"></a>TQWidget::move ( int x, int y )<tt> [virtual slot]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This corresponds to <a href="#move">move</a>( <a href="qpoint.html">TQPoint</a>(<em>x</em>, <em>y</em>) ). - -<h3 class=fn>void <a name="moveEvent"></a>TQWidget::moveEvent ( <a href="qmoveevent.html">TQMoveEvent</a> * )<tt> [virtual protected]</tt> -</h3> -This event handler can be reimplemented in a subclass to receive -widget move events. When the widget receives this event, it is -already at the new position. -<p> The old position is accessible through <a href="qmoveevent.html#oldPos">TQMoveEvent::oldPos</a>(). -<p> <p>See also <a href="#resizeEvent">resizeEvent</a>(), <a href="#event">event</a>(), <a href="#pos-prop">pos</a>, and <a href="qmoveevent.html">TQMoveEvent</a>. - -<h3 class=fn>bool <a name="ownCursor"></a>TQWidget::ownCursor () const -</h3><p>Returns TRUE if the widget uses its own cursor; otherwise returns FALSE. -See the <a href="qwidget.html#ownCursor-prop">"ownCursor"</a> property for details. -<h3 class=fn>bool <a name="ownFont"></a>TQWidget::ownFont () const -</h3><p>Returns TRUE if the widget uses its own font; otherwise returns FALSE. -See the <a href="qwidget.html#ownFont-prop">"ownFont"</a> property for details. -<h3 class=fn>bool <a name="ownPalette"></a>TQWidget::ownPalette () const -</h3><p>Returns TRUE if the widget uses its own palette; otherwise returns FALSE. -See the <a href="qwidget.html#ownPalette-prop">"ownPalette"</a> property for details. -<h3 class=fn>void <a name="paintEvent"></a>TQWidget::paintEvent ( <a href="qpaintevent.html">TQPaintEvent</a> * )<tt> [virtual protected]</tt> -</h3> -This event handler can be reimplemented in a subclass to receive -paint events. -<p> A paint event is a request to repaint all or part of the widget. -It can happen as a result of <a href="#repaint">repaint</a>() or <a href="#update">update</a>(), or because the -widget was obscured and has now been uncovered, or for many other -reasons. -<p> Many widgets can simply repaint their entire surface when asked -to, but some slow widgets need to optimize by painting only the -requested region: <a href="qpaintevent.html#region">TQPaintEvent::region</a>(). This speed optimization -does not change the result, as painting is clipped to that region -during event processing. <a href="qlistview.html">TQListView</a> and <a href="qcanvas.html">TQCanvas</a> do this, for -example. -<p> TQt also tries to speed up painting by merging multiple paint -events into one. When update() is called several times or the -window system sends several paint events, TQt merges these events -into one event with a larger region (see <a href="qregion.html#unite">TQRegion::unite</a>()). -repaint() does not permit this optimization, so we suggest using -update() when possible. -<p> When the paint event occurs, the update region has normally been -erased, so that you're painting on the widget's background. There -are a couple of exceptions and <a href="qpaintevent.html#erased">TQPaintEvent::erased</a>() tells you -whether the widget has been erased or not. -<p> The background can be set using <a href="#setBackgroundMode">setBackgroundMode</a>(), -<a href="#setPaletteBackgroundColor">setPaletteBackgroundColor</a>() or <a href="#setBackgroundPixmap">setBackgroundPixmap</a>(). The -documentation for setBackgroundMode() elaborates on the -background; we recommend reading it. -<p> <p>See also <a href="#event">event</a>(), <a href="#repaint">repaint</a>(), <a href="#update">update</a>(), <a href="qpainter.html">TQPainter</a>, <a href="qpixmap.html">TQPixmap</a>, and <a href="qpaintevent.html">TQPaintEvent</a>. - -<p>Examples: <a href="drawlines-example.html#x1661">drawlines/connect.cpp</a>, <a href="forever-example.html#x1055">forever/forever.cpp</a>, <a href="qmag-example.html#x1803">qmag/qmag.cpp</a>, <a href="scribble-example.html#x951">scribble/scribble.cpp</a>, <a href="splitter-example.html#x1302">splitter/splitter.cpp</a>, <a href="tutorial1-08.html#x2336">t8/cannon.cpp</a>, and <a href="tutorial1-09.html#x2346">t9/cannon.cpp</a>. -<p>Reimplemented in <a href="qbutton.html#paintEvent">TQButton</a>, <a href="qframe.html#paintEvent">TQFrame</a>, <a href="qglwidget.html#paintEvent">TQGLWidget</a>, <a href="qsizegrip.html#paintEvent">TQSizeGrip</a>, <a href="qstatusbar.html#paintEvent">TQStatusBar</a>, and <a href="qtabbar.html#paintEvent">TQTabBar</a>. -<h3 class=fn>const <a href="qpalette.html">TQPalette</a> & <a name="palette"></a>TQWidget::palette () const -</h3><p>Returns the widget's palette. -See the <a href="qwidget.html#palette-prop">"palette"</a> property for details. -<h3 class=fn>const <a href="qcolor.html">TQColor</a> & <a name="paletteBackgroundColor"></a>TQWidget::paletteBackgroundColor () const -</h3><p>Returns the background color of the widget. -See the <a href="qwidget.html#paletteBackgroundColor-prop">"paletteBackgroundColor"</a> property for details. -<h3 class=fn>const <a href="qpixmap.html">TQPixmap</a> * <a name="paletteBackgroundPixmap"></a>TQWidget::paletteBackgroundPixmap () const -</h3><p>Returns the background pixmap of the widget. -See the <a href="qwidget.html#paletteBackgroundPixmap-prop">"paletteBackgroundPixmap"</a> property for details. -<h3 class=fn>void <a name="paletteChange"></a>TQWidget::paletteChange ( const <a href="qpalette.html">TQPalette</a> & oldPalette )<tt> [virtual protected]</tt> -</h3> - -<p> This virtual function is called from <a href="#setPalette">setPalette</a>(). <em>oldPalette</em> -is the previous palette; you can get the new palette from -<a href="#palette">palette</a>(). -<p> Reimplement this function if your widget needs to know when its -palette changes. -<p> <p>See also <a href="#palette-prop">palette</a> and <a href="#palette-prop">palette</a>. - -<h3 class=fn>const <a href="qcolor.html">TQColor</a> & <a name="paletteForegroundColor"></a>TQWidget::paletteForegroundColor () const -</h3><p>Returns the foreground color of the widget. -See the <a href="qwidget.html#paletteForegroundColor-prop">"paletteForegroundColor"</a> property for details. -<h3 class=fn><a href="qwidget.html">TQWidget</a> * <a name="parentWidget"></a>TQWidget::parentWidget ( bool sameWindow = FALSE ) const -</h3> - -<p> Returns the parent of this widget, or 0 if it does not have any -parent widget. If <em>sameWindow</em> is TRUE and the widget is top -level returns 0; otherwise returns the widget's parent. - -<p>Example: <a href="mdi-example.html#x2081">mdi/application.cpp</a>. -<h3 class=fn>void <a name="polish"></a>TQWidget::polish ()<tt> [virtual slot]</tt> -</h3> -Delayed initialization of a widget. -<p> This function will be called <em>after</em> a widget has been fully -created and <em>before</em> it is shown the very first time. -<p> Polishing is useful for final initialization which depends on -having an instantiated widget. This is something a constructor -cannot guarantee since the initialization of the subclasses might -not be finished. -<p> After this function, the widget has a proper font and palette and -<a href="qapplication.html#polish">TQApplication::polish</a>() has been called. -<p> Remember to call TQWidget's implementation first when reimplementing this -function to ensure that your program does not end up in infinite recursion. -<p> <p>See also <a href="#constPolish">constPolish</a>() and <a href="qapplication.html#polish">TQApplication::polish</a>(). - -<p>Example: <a href="menu-example.html#x1883">menu/menu.cpp</a>. -<h3 class=fn><a href="qpoint.html">TQPoint</a> <a name="pos"></a>TQWidget::pos () const -</h3><p>Returns the position of the widget within its parent widget. -See the <a href="qwidget.html#pos-prop">"pos"</a> property for details. -<h3 class=fn>bool <a name="qwsEvent"></a>TQWidget::qwsEvent ( TQWSEvent * )<tt> [virtual protected]</tt> -</h3> -This special event handler can be reimplemented in a subclass to -receive native TQt/Embedded events. -<p> In your reimplementation of this function, if you want to stop the -event being handled by TQt, return TRUE. If you return FALSE, this -native event is passed back to TQt, which translates the event into -a TQt event and sends it to the widget. -<p> <b>Warning:</b> This function is not portable. -<p> <p>See also <a href="qapplication.html#qwsEventFilter">TQApplication::qwsEventFilter</a>(). - -<h3 class=fn>void <a name="raise"></a>TQWidget::raise ()<tt> [slot]</tt> -</h3> -Raises this widget to the top of the parent widget's stack. -<p> After this call the widget will be visually in front of any -overlapping sibling widgets. -<p> <p>See also <a href="#lower">lower</a>() and <a href="#stackUnder">stackUnder</a>(). - -<p>Example: <a href="showimg-example.html#x1352">showimg/showimg.cpp</a>. -<h3 class=fn>void <a name="recreate"></a>TQWidget::recreate ( <a href="qwidget.html">TQWidget</a> * parent, WFlags f, const <a href="qpoint.html">TQPoint</a> & p, bool showIt = FALSE ) -</h3> - -<p> <b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -<p> This method is provided to aid porting from TQt 1.0 to 2.0. It has -been renamed <a href="#reparent">reparent</a>() in TQt 2.0. - -<h3 class=fn><a href="qrect.html">TQRect</a> <a name="rect"></a>TQWidget::rect () const -</h3><p>Returns the internal geometry of the widget excluding any window frame. -See the <a href="qwidget.html#rect-prop">"rect"</a> property for details. -<h3 class=fn>void <a name="releaseKeyboard"></a>TQWidget::releaseKeyboard () -</h3> -Releases the keyboard grab. -<p> <p>See also <a href="#grabKeyboard">grabKeyboard</a>(), <a href="#grabMouse">grabMouse</a>(), and <a href="#releaseMouse">releaseMouse</a>(). - -<h3 class=fn>void <a name="releaseMouse"></a>TQWidget::releaseMouse () -</h3> -Releases the mouse grab. -<p> <p>See also <a href="#grabMouse">grabMouse</a>(), <a href="#grabKeyboard">grabKeyboard</a>(), and <a href="#releaseKeyboard">releaseKeyboard</a>(). - -<h3 class=fn>void <a name="repaint"></a>TQWidget::repaint ( int x, int y, int w, int h, bool erase = TRUE )<tt> [slot]</tt> -</h3> -Repaints the widget directly by calling <a href="#paintEvent">paintEvent</a>() immediately, -unless updates are disabled or the widget is hidden. -<p> If <em>erase</em> is TRUE, TQt erases the area <em>(x, y, w, h)</em> before the -paintEvent() call. -<p> If <em>w</em> is negative, it is replaced with <tt>width() - x</tt>, and if -<em>h</em> is negative, it is replaced width <tt>height() - y</tt>. -<p> We suggest only using <a href="#repaint">repaint</a>() if you need an immediate repaint, -for example during animation. In almost all circumstances <a href="#update">update</a>() -is better, as it permits TQt to optimize for speed and minimize -flicker. -<p> <b>Warning:</b> If you call repaint() in a function which may itself be -called from paintEvent(), you may get infinite recursion. The -update() function never causes recursion. -<p> <p>See also <a href="#update">update</a>(), <a href="#paintEvent">paintEvent</a>(), <a href="#updatesEnabled-prop">updatesEnabled</a>, and <a href="#erase">erase</a>(). - -<p>Example: <a href="qwerty-example.html#x407">qwerty/qwerty.cpp</a>. -<h3 class=fn>void <a name="repaint-2"></a>TQWidget::repaint ()<tt> [slot]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This version erases and repaints the entire widget. - -<h3 class=fn>void <a name="repaint-3"></a>TQWidget::repaint ( bool erase )<tt> [slot]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This version repaints the entire widget. - -<h3 class=fn>void <a name="repaint-4"></a>TQWidget::repaint ( const <a href="qrect.html">TQRect</a> & r, bool erase = TRUE )<tt> [slot]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Repaints the widget directly by calling <a href="#paintEvent">paintEvent</a>() directly, -unless updates are disabled or the widget is hidden. -<p> Erases the widget region <em>r</em> if <em>erase</em> is TRUE. - -<h3 class=fn>void <a name="repaint-5"></a>TQWidget::repaint ( const <a href="qregion.html">TQRegion</a> & reg, bool erase = TRUE )<tt> [slot]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Repaints the widget directly by calling <a href="#paintEvent">paintEvent</a>() directly, -unless updates are disabled or the widget is hidden. -<p> Erases the widget region <em>reg</em> if <em>erase</em> is TRUE. -<p> Only use repaint if your widget needs to be repainted immediately, -for example when doing some animation. In all other cases, use -<a href="#update">update</a>(). Calling update() many times in a row will generate a -single paint event. -<p> <b>Warning:</b> If you call <a href="#repaint">repaint</a>() in a function which may itself be -called from paintEvent(), you may get infinite recursion. The -update() function never causes recursion. -<p> <p>See also <a href="#update">update</a>(), <a href="#paintEvent">paintEvent</a>(), <a href="#updatesEnabled-prop">updatesEnabled</a>, and <a href="#erase">erase</a>(). - -<h3 class=fn>void <a name="reparent"></a>TQWidget::reparent ( <a href="qwidget.html">TQWidget</a> * parent, WFlags f, const <a href="qpoint.html">TQPoint</a> & p, bool showIt = FALSE )<tt> [virtual]</tt> -</h3> -Reparents the widget. The widget gets a new <em>parent</em>, new widget -flags (<em>f</em>, but as usual, use 0) at a new position in its new -parent (<em>p</em>). -<p> If <em>showIt</em> is TRUE, <a href="#show">show</a>() is called once the widget has been -reparented. -<p> If the new parent widget is in a different top-level widget, the -reparented widget and its children are appended to the end of the -<a href="#setFocusPolicy">tab chain</a> of the new parent -widget, in the same internal order as before. If one of the moved -widgets had <a href="focus.html#keyboard-focus">keyboard focus</a>, <a href="#reparent">reparent</a>() calls <a href="#clearFocus">clearFocus</a>() for that -widget. -<p> If the new parent widget is in the same top-level widget as the -old parent, reparent doesn't change the tab order or keyboard -focus. -<p> <b>Warning:</b> It is extremely unlikely that you will ever need this -function. If you have a widget that changes its content -dynamically, it is far easier to use <a href="qwidgetstack.html">TQWidgetStack</a> or <a href="qwizard.html">TQWizard</a>. -<p> <p>See also <a href="#getWFlags">getWFlags</a>(). - -<p>Example: <a href="toplevel-example.html#x2538">toplevel/options.ui.h</a>. -<h3 class=fn>void <a name="reparent-2"></a>TQWidget::reparent ( <a href="qwidget.html">TQWidget</a> * parent, const <a href="qpoint.html">TQPoint</a> & p, bool showIt = FALSE ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> A convenience version of reparent that does not take widget flags -as argument. -<p> Calls <a href="#reparent">reparent</a>(<em>parent</em>, <a href="#getWFlags">getWFlags</a>() & ~<a href="qt.html#WidgetFlags-enum">WType_Mask</a>, <em>p</em>, <em>showIt</em>). - -<h3 class=fn>void <a name="resetInputContext"></a>TQWidget::resetInputContext ()<tt> [protected]</tt> -</h3> -This function is called when the user finishes input composition, -e.g. changes focus to another widget, moves the cursor, etc. - -<h3 class=fn>void <a name="resize"></a>TQWidget::resize ( const <a href="qsize.html">TQSize</a> & )<tt> [slot]</tt> -</h3><p>Sets the size of the widget excluding any window frame. -See the <a href="qwidget.html#size-prop">"size"</a> property for details. -<h3 class=fn>void <a name="resize-2"></a>TQWidget::resize ( int w, int h )<tt> [virtual slot]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This corresponds to <a href="#resize">resize</a>( <a href="qsize.html">TQSize</a>(<em>w</em>, <em>h</em>) ). - -<h3 class=fn>void <a name="resizeEvent"></a>TQWidget::resizeEvent ( <a href="qresizeevent.html">TQResizeEvent</a> * )<tt> [virtual protected]</tt> -</h3> -This event handler can be reimplemented in a subclass to receive -widget resize events. When <a href="#resizeEvent">resizeEvent</a>() is called, the widget -already has its new geometry. The old size is accessible through -<a href="qresizeevent.html#oldSize">TQResizeEvent::oldSize</a>(). -<p> The widget will be erased and receive a paint event immediately -after processing the resize event. No drawing need be (or should -be) done inside this handler. -<p> Widgets that have been created with the <a href="qt.html#WidgetFlags-enum">WNoAutoErase</a> flag -will not be erased. Nevertheless, they will receive a paint event -for their entire area afterwards. Again, no drawing needs to be -done inside this handler. -<p> The default implementation calls <a href="#updateMask">updateMask</a>() if the widget has -<a href="#setAutoMask">automatic masking</a> enabled. -<p> <p>See also <a href="#moveEvent">moveEvent</a>(), <a href="#event">event</a>(), <a href="#size-prop">size</a>, <a href="qresizeevent.html">TQResizeEvent</a>, and <a href="#paintEvent">paintEvent</a>(). - -<p>Examples: <a href="drawdemo-example.html#x1089">drawdemo/drawdemo.cpp</a>, <a href="menu-example.html#x1884">menu/menu.cpp</a>, <a href="qmag-example.html#x1806">qmag/qmag.cpp</a>, <a href="scribble-example.html#x952">scribble/scribble.cpp</a>, <a href="showimg-example.html#x1353">showimg/showimg.cpp</a>, <a href="tooltip-example.html#x454">tooltip/tooltip.cpp</a>, and <a href="xform-example.html#x1269">xform/xform.cpp</a>. -<p>Reimplemented in <a href="qframe.html#resizeEvent">TQFrame</a> and <a href="qglwidget.html#resizeEvent">TQGLWidget</a>. -<h3 class=fn>void <a name="scroll"></a>TQWidget::scroll ( int dx, int dy ) -</h3> -Scrolls the widget including its children <em>dx</em> pixels to the -right and <em>dy</em> downwards. Both <em>dx</em> and <em>dy</em> may be negative. -<p> After scrolling, <a href="#scroll">scroll</a>() sends a paint event for the the part -that is read but not written. For example, when scrolling 10 -pixels rightwards, the leftmost ten pixels of the widget need -repainting. The paint event may be delivered immediately or later, -depending on some heuristics (note that you might have to force -processing of paint events using <a href="qapplication.html#sendPostedEvents">TQApplication::sendPostedEvents</a>() -when using scroll() and <a href="#move">move</a>() in combination). -<p> <p>See also <a href="qscrollview.html">TQScrollView</a>, <a href="#erase">erase</a>(), and <a href="qpaintdevice.html#bitBlt">bitBlt</a>(). - -<h3 class=fn>void <a name="scroll-2"></a>TQWidget::scroll ( int dx, int dy, const <a href="qrect.html">TQRect</a> & r ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This version only scrolls <em>r</em> and does not move the children of -the widget. -<p> If <em>r</em> is empty or invalid, the result is undefined. -<p> <p>See also <a href="qscrollview.html">TQScrollView</a>, <a href="#erase">erase</a>(), and <a href="qpaintdevice.html#bitBlt">bitBlt</a>(). - -<h3 class=fn>void <a name="setAcceptDrops"></a>TQWidget::setAcceptDrops ( bool on )<tt> [virtual]</tt> -</h3><p>Sets whether drop events are enabled for this widget to <em>on</em>. -See the <a href="qwidget.html#acceptDrops-prop">"acceptDrops"</a> property for details. -<h3 class=fn>void <a name="setActiveWindow"></a>TQWidget::setActiveWindow ()<tt> [virtual]</tt> -</h3> -Sets the top-level widget containing this widget to be the active -window. -<p> An active window is a visible top-level window that has the -keyboard input focus. -<p> This function performs the same operation as clicking the mouse on -the title bar of a top-level window. On X11, the result depends on -the Window Manager. If you want to ensure that the window is -stacked on top as well you should also call <a href="#raise">raise</a>(). Note that the -window must be visible, otherwise <a href="#setActiveWindow">setActiveWindow</a>() has no effect. -<p> On Windows, if you are calling this when the application is not -currently the active one then it will not make it the active -window. It will flash the task bar entry blue to indicate that -the window has done something. This is because Microsoft do not -allow an application to interrupt what the user is currently doing -in another application. -<p> <p>See also <a href="#isActiveWindow-prop">isActiveWindow</a>, <a href="#topLevelWidget">topLevelWidget</a>(), and <a href="#show">show</a>(). - -<p>Reimplemented in <a href="qxtwidget.html#setActiveWindow">TQXtWidget</a>. -<h3 class=fn>void <a name="setAutoMask"></a>TQWidget::setAutoMask ( bool )<tt> [virtual]</tt> -</h3><p>Sets whether the auto mask feature is enabled for the widget. -See the <a href="qwidget.html#autoMask-prop">"autoMask"</a> property for details. -<h3 class=fn>void <a name="setBackgroundColor"></a>TQWidget::setBackgroundColor ( const <a href="qcolor.html">TQColor</a> & c )<tt> [virtual]</tt> -</h3><b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -Use <a href="#setPaletteBackgroundColor">setPaletteBackgroundColor</a>() or <a href="#setEraseColor">setEraseColor</a>() instead. -<p>Examples: <a href="customlayout-example.html#x1540">customlayout/main.cpp</a>, <a href="desktop-example.html#x1761">desktop/desktop.cpp</a>, <a href="hello-example.html#x1648">hello/main.cpp</a>, <a href="movies-example.html#x523">movies/main.cpp</a>, and <a href="splitter-example.html#x1303">splitter/splitter.cpp</a>. -<h3 class=fn>void <a name="setBackgroundMode"></a>TQWidget::setBackgroundMode ( <a href="qt.html#BackgroundMode-enum">BackgroundMode</a> )<tt> [virtual]</tt> -</h3><p>Sets the color role used for painting the background of the widget. -See the <a href="qwidget.html#backgroundMode-prop">"backgroundMode"</a> property for details. -<h3 class=fn>void <a name="setBackgroundMode-2"></a>TQWidget::setBackgroundMode ( <a href="qt.html#BackgroundMode-enum">BackgroundMode</a> m, <a href="qt.html#BackgroundMode-enum">BackgroundMode</a> visual ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Sets the widget's own background mode to <em>m</em> and the visual -background mode to <em>visual</em>. The visual background mode is used -with the designable properties <tt>backgroundColor</tt>, <tt>foregroundColor</tt> and <tt>backgroundPixmap</tt>. -<p> For complex controls, the logical background mode sometimes -differs from a widget's own background mode. A spinbox for example -has <a href="qt.html#BackgroundMode-enum">PaletteBackground</a> as background mode (typically dark gray), -while it's embedded lineedit control uses <a href="qt.html#BackgroundMode-enum">PaletteBase</a> -(typically white). Since the lineedit covers most of the visual -area of a spinbox, it defines <a href="qt.html#BackgroundMode-enum">PaletteBase</a> to be its <em>visual</em> -background mode. Changing the <tt>backgroundColor</tt> property thus -changes the lineedit control's background, which is exactly what -the user expects in <em>TQt Designer</em>. - -<h3 class=fn>void <a name="setBackgroundOrigin"></a>TQWidget::setBackgroundOrigin ( <a href="qwidget.html#BackgroundOrigin-enum">BackgroundOrigin</a> )<tt> [virtual]</tt> -</h3><p>Sets the origin of the widget's background. -See the <a href="qwidget.html#backgroundOrigin-prop">"backgroundOrigin"</a> property for details. -<h3 class=fn>void <a name="setBackgroundPixmap"></a>TQWidget::setBackgroundPixmap ( const <a href="qpixmap.html">TQPixmap</a> & pm )<tt> [virtual]</tt> -</h3><b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -Use <a href="#setPaletteBackgroundPixmap">setPaletteBackgroundPixmap</a>() or <a href="#setErasePixmap">setErasePixmap</a>() instead. -<p>Example: <a href="desktop-example.html#x1762">desktop/desktop.cpp</a>. -<h3 class=fn>void <a name="setBaseSize"></a>TQWidget::setBaseSize ( const <a href="qsize.html">TQSize</a> & ) -</h3><p>Sets the base size of the widget. -See the <a href="qwidget.html#baseSize-prop">"baseSize"</a> property for details. -<h3 class=fn>void <a name="setBaseSize-2"></a>TQWidget::setBaseSize ( int basew, int baseh ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This corresponds to <a href="#setBaseSize">setBaseSize</a>( <a href="qsize.html">TQSize</a>(<em>basew</em>, <em>baseh</em>) ). Sets -the widgets base size to width <em>basew</em> and height <em>baseh</em>. - -<h3 class=fn>void <a name="setCaption"></a>TQWidget::setCaption ( const <a href="qstring.html">TQString</a> & )<tt> [virtual slot]</tt> -</h3><p>Sets the window caption (title). -See the <a href="qwidget.html#caption-prop">"caption"</a> property for details. -<h3 class=fn>void <a name="setCursor"></a>TQWidget::setCursor ( const <a href="qcursor.html">TQCursor</a> & )<tt> [virtual]</tt> -</h3><p>Sets the cursor shape for this widget. -See the <a href="qwidget.html#cursor-prop">"cursor"</a> property for details. -<h3 class=fn>void <a name="setDisabled"></a>TQWidget::setDisabled ( bool disable )<tt> [slot]</tt> -</h3> -Disables widget input events if <em>disable</em> is TRUE; otherwise -enables input events. -<p> See the <a href="#enabled-prop">enabled</a> documentation for more information. -<p> <p>See also <a href="#isEnabledTo">isEnabledTo</a>(), <a href="qkeyevent.html">TQKeyEvent</a>, <a href="qmouseevent.html">TQMouseEvent</a>, and <a href="#enabledChange">enabledChange</a>(). - -<h3 class=fn>void <a name="setEnabled"></a>TQWidget::setEnabled ( bool )<tt> [virtual slot]</tt> -</h3><p>Sets whether the widget is enabled. -See the <a href="qwidget.html#enabled-prop">"enabled"</a> property for details. -<h3 class=fn>void <a name="setEraseColor"></a>TQWidget::setEraseColor ( const <a href="qcolor.html">TQColor</a> & color )<tt> [virtual]</tt> -</h3> -Sets the erase color of the widget to <em>color</em>. -<p> The erase color is the color the widget is to be cleared to before -<a href="#paintEvent">paintEvent</a>() is called. If there is an erase pixmap (set using -<a href="#setErasePixmap">setErasePixmap</a>()), then this property has an indeterminate value. -<p> <p>See also <a href="#erasePixmap">erasePixmap</a>(), <a href="#backgroundColor">backgroundColor</a>(), <a href="#backgroundMode-prop">backgroundMode</a>, and <a href="#palette-prop">palette</a>. - -<h3 class=fn>void <a name="setErasePixmap"></a>TQWidget::setErasePixmap ( const <a href="qpixmap.html">TQPixmap</a> & pixmap )<tt> [virtual]</tt> -</h3> -Sets the widget's erase pixmap to <em>pixmap</em>. -<p> This pixmap is used to clear the widget before <a href="#paintEvent">paintEvent</a>() is -called. - -<h3 class=fn>void <a name="setFixedHeight"></a>TQWidget::setFixedHeight ( int h ) -</h3> -Sets both the minimum and maximum heights of the widget to <em>h</em> -without changing the widths. Provided for convenience. -<p> <p>See also <a href="#sizeHint-prop">sizeHint</a>, <a href="#minimumSize-prop">minimumSize</a>, <a href="#maximumSize-prop">maximumSize</a>, and <a href="#setFixedSize">setFixedSize</a>(). - -<p>Examples: <a href="simple-font-demo-example.html#x2859">fonts/simple-qfont-demo/viewer.cpp</a>, <a href="layout-example.html#x545">layout/layout.cpp</a>, <a href="qdir-example.html#x1852">qdir/qdir.cpp</a>, and <a href="showimg-example.html#x1354">showimg/showimg.cpp</a>. -<h3 class=fn>void <a name="setFixedSize"></a>TQWidget::setFixedSize ( const <a href="qsize.html">TQSize</a> & s ) -</h3> -Sets both the minimum and maximum sizes of the widget to <em>s</em>, -thereby preventing it from ever growing or shrinking. -<p> <p>See also <a href="#maximumSize-prop">maximumSize</a> and <a href="#minimumSize-prop">minimumSize</a>. - -<h3 class=fn>void <a name="setFixedSize-2"></a>TQWidget::setFixedSize ( int w, int h ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Sets the width of the widget to <em>w</em> and the height to <em>h</em>. - -<h3 class=fn>void <a name="setFixedWidth"></a>TQWidget::setFixedWidth ( int w ) -</h3> -Sets both the minimum and maximum width of the widget to <em>w</em> -without changing the heights. Provided for convenience. -<p> <p>See also <a href="#sizeHint-prop">sizeHint</a>, <a href="#minimumSize-prop">minimumSize</a>, <a href="#maximumSize-prop">maximumSize</a>, and <a href="#setFixedSize">setFixedSize</a>(). - -<p>Examples: <a href="progressbar-example.html#x974">progressbar/progressbar.cpp</a> and <a href="qdir-example.html#x1853">qdir/qdir.cpp</a>. -<h3 class=fn>void <a name="setFocus"></a>TQWidget::setFocus ()<tt> [virtual slot]</tt> -</h3> -Gives the keyboard input focus to this widget (or its focus -proxy) if this widget or one of its parents is the <a href="#isActiveWindow">active window</a>. -<p> First, a focus out event is sent to the focus widget (if any) to -tell it that it is about to lose the focus. Then a focus in event -is sent to this widget to tell it that it just received the focus. -(Nothing happens if the focus in and focus out widgets are the -same.) -<p> <a href="#setFocus">setFocus</a>() gives focus to a widget regardless of its focus policy, -but does not clear any keyboard grab (see <a href="#grabKeyboard">grabKeyboard</a>()). -<p> Be aware that if the widget is hidden, it will not accept focus. -<p> <b>Warning:</b> If you call setFocus() in a function which may itself be -called from <a href="#focusOutEvent">focusOutEvent</a>() or <a href="#focusInEvent">focusInEvent</a>(), you may get an -infinite recursion. -<p> <p>See also <a href="#focus-prop">focus</a>, <a href="#clearFocus">clearFocus</a>(), <a href="#focusInEvent">focusInEvent</a>(), <a href="#focusOutEvent">focusOutEvent</a>(), <a href="#focusPolicy-prop">focusPolicy</a>, <a href="qapplication.html#focusWidget">TQApplication::focusWidget</a>(), <a href="#grabKeyboard">grabKeyboard</a>(), and <a href="#grabMouse">grabMouse</a>(). - -<p>Examples: <a href="addressbook-example.html#x606">addressbook/centralwidget.cpp</a>, <a href="lineedits-example.html#x181">lineedits/lineedits.cpp</a>, <a href="mdi-example.html#x2084">mdi/application.cpp</a>, <a href="popup-example.html#x1625">popup/popup.cpp</a>, <a href="rot-example.html#x1378">rot13/rot13.cpp</a>, <a href="tutorial1-08.html#x2339">t8/main.cpp</a>, and <a href="wizard-example.html#x11">wizard/wizard.cpp</a>. -<h3 class=fn>void <a name="setFocusPolicy"></a>TQWidget::setFocusPolicy ( <a href="qwidget.html#FocusPolicy-enum">FocusPolicy</a> )<tt> [virtual]</tt> -</h3><p>Sets the way the widget accepts keyboard focus. -See the <a href="qwidget.html#focusPolicy-prop">"focusPolicy"</a> property for details. -<h3 class=fn>void <a name="setFocusProxy"></a>TQWidget::setFocusProxy ( <a href="qwidget.html">TQWidget</a> * w )<tt> [virtual]</tt> -</h3> -Sets the widget's focus proxy to widget <em>w</em>. If <em>w</em> is 0, the -function resets this widget to have no focus proxy. -<p> Some widgets, such as <a href="qcombobox.html">TQComboBox</a>, can "have focus", but create a -child widget to actually handle the focus. TQComboBox, for example, -creates a <a href="qlineedit.html">TQLineEdit</a> which handles the focus. -<p> <a href="#setFocusProxy">setFocusProxy</a>() sets the widget which will actually get focus when -"this widget" gets it. If there is a focus proxy, <a href="#focusPolicy">focusPolicy</a>(), -<a href="#setFocusPolicy">setFocusPolicy</a>(), <a href="#setFocus">setFocus</a>() and <a href="#hasFocus">hasFocus</a>() all operate on the -focus proxy. -<p> <p>See also <a href="#focusProxy">focusProxy</a>(). - -<h3 class=fn>void <a name="setFont"></a>TQWidget::setFont ( const <a href="qfont.html">TQFont</a> & )<tt> [virtual]</tt> -</h3><p>Sets the font currently set for the widget. -See the <a href="qwidget.html#font-prop">"font"</a> property for details. -<p>Reimplemented in <a href="qcombobox.html#setFont">TQComboBox</a>, <a href="qlabel.html#setFont">TQLabel</a>, and <a href="qtabdialog.html#setFont">TQTabDialog</a>. -<h3 class=fn>void <a name="setFont-2"></a>TQWidget::setFont ( const <a href="qfont.html">TQFont</a> & f, bool ) -</h3> - -<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -<p> Use <a href="#setFont">setFont</a>(const <a href="qfont.html">TQFont</a>& font) instead. - -<h3 class=fn>void <a name="setGeometry"></a>TQWidget::setGeometry ( const <a href="qrect.html">TQRect</a> & )<tt> [virtual slot]</tt> -</h3><p>Sets the geometry of the widget relative to its parent and excluding the window frame. -See the <a href="qwidget.html#geometry-prop">"geometry"</a> property for details. -<h3 class=fn>void <a name="setGeometry-2"></a>TQWidget::setGeometry ( int x, int y, int w, int h )<tt> [virtual slot]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This corresponds to <a href="#setGeometry">setGeometry</a>( <a href="qrect.html">TQRect</a>(<em>x</em>, <em>y</em>, <em>w</em>, <em>h</em>) ). - -<h3 class=fn>void <a name="setHidden"></a>TQWidget::setHidden ( bool hide )<tt> [slot]</tt> -</h3><p>Sets whether the widget is explicitly hidden to <em>hide</em>. -See the <a href="qwidget.html#hidden-prop">"hidden"</a> property for details. -<h3 class=fn>void <a name="setIcon"></a>TQWidget::setIcon ( const <a href="qpixmap.html">TQPixmap</a> & )<tt> [virtual slot]</tt> -</h3><p>Sets the widget's icon. -See the <a href="qwidget.html#icon-prop">"icon"</a> property for details. -<h3 class=fn>void <a name="setIconText"></a>TQWidget::setIconText ( const <a href="qstring.html">TQString</a> & )<tt> [virtual slot]</tt> -</h3><p>Sets the widget's icon text. -See the <a href="qwidget.html#iconText-prop">"iconText"</a> property for details. -<h3 class=fn>void <a name="setInputMethodEnabled"></a>TQWidget::setInputMethodEnabled ( bool b ) -</h3><p>Sets enables or disables the use of input methods for this widget to <em>b</em>. -See the <a href="qwidget.html#inputMethodEnabled-prop">"inputMethodEnabled"</a> property for details. -<h3 class=fn>void <a name="setKeyCompression"></a>TQWidget::setKeyCompression ( bool compress )<tt> [virtual protected]</tt> -</h3> -Enables key event compression, if <em>compress</em> is TRUE, and -disables it if <em>compress</em> is FALSE. -<p> Key compression is off by default (except for <a href="qlineedit.html">TQLineEdit</a> and -<a href="qtextedit.html">TQTextEdit</a>), so widgets receive one key press event for each key -press (or more, since autorepeat is usually on). If you turn it on -and your program doesn't keep up with key input, TQt may try to -compress key events so that more than one character can be -processed in each event. -<p> For example, a word processor widget might receive 2, 3 or more -characters in each <a href="qkeyevent.html#text">TQKeyEvent::text</a>(), if the layout recalculation -takes too long for the CPU. -<p> If a widget supports multiple character unicode input, it is -always safe to turn the compression on. -<p> TQt performs key event compression only for printable characters. -Modifier keys, cursor movement keys, function keys and -miscellaneous action keys (e.g. Escape, Enter, Backspace, -PrintScreen) will stop key event compression, even if there are -more compressible key events available. -<p> Not all platforms support this compression, in which case turning -it on will have no effect. -<p> <p>See also <a href="qkeyevent.html#text">TQKeyEvent::text</a>(). - -<h3 class=fn>void <a name="setMask"></a>TQWidget::setMask ( const <a href="qbitmap.html">TQBitmap</a> & bitmap )<tt> [virtual]</tt> -</h3> -Causes only the pixels of the widget for which <em>bitmap</em> has a -corresponding 1 bit to be visible. Use TQt::color0 to draw -transparent regions and TQt::color1 to draw opaque regions of the -bitmap. -<p> If the region includes pixels outside the <a href="#rect">rect</a>() of the widget, -window system controls in that area may or may not be visible, -depending on the platform. -<p> Note that this effect can be slow if the region is particularly -complex. -<p> See <tt>examples/tux</tt> for an example of masking for transparency. -<p> <p>See also <a href="#clearMask">clearMask</a>(). - -<h3 class=fn>void <a name="setMask-2"></a>TQWidget::setMask ( const <a href="qregion.html">TQRegion</a> & region )<tt> [virtual]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Causes only the parts of the widget which overlap <em>region</em> to be -visible. If the region includes pixels outside the <a href="#rect">rect</a>() of the -widget, window system controls in that area may or may not be -visible, depending on the platform. -<p> Note that this effect can be slow if the region is particularly -complex. -<p> <p>See also <a href="#clearMask">clearMask</a>(). - -<h3 class=fn>void <a name="setMaximumHeight"></a>TQWidget::setMaximumHeight ( int maxh ) -</h3><p>Sets the widget's maximum height to <em>maxh</em>. -See the <a href="qwidget.html#maximumHeight-prop">"maximumHeight"</a> property for details. -<h3 class=fn>void <a name="setMaximumSize"></a>TQWidget::setMaximumSize ( const <a href="qsize.html">TQSize</a> & ) -</h3><p>Sets the widget's maximum size. -See the <a href="qwidget.html#maximumSize-prop">"maximumSize"</a> property for details. -<h3 class=fn>void <a name="setMaximumSize-2"></a>TQWidget::setMaximumSize ( int maxw, int maxh )<tt> [virtual]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This function corresponds to <a href="#setMaximumSize">setMaximumSize</a>( <a href="qsize.html">TQSize</a>(<em>maxw</em>, <em>maxh</em>) ). Sets the maximum width to <em>maxw</em> and the maximum height -to <em>maxh</em>. - -<h3 class=fn>void <a name="setMaximumWidth"></a>TQWidget::setMaximumWidth ( int maxw ) -</h3><p>Sets the widget's maximum width to <em>maxw</em>. -See the <a href="qwidget.html#maximumWidth-prop">"maximumWidth"</a> property for details. -<h3 class=fn>void <a name="setMicroFocusHint"></a>TQWidget::setMicroFocusHint ( int x, int y, int width, int height, bool text = TRUE, <a href="qfont.html">TQFont</a> * f = 0 )<tt> [virtual protected]</tt> -</h3> -When a widget gets focus, it should call <a href="#setMicroFocusHint">setMicroFocusHint</a>() with -some appropriate position and size, <em>x</em>, <em>y</em>, <em>width</em> and <em>height</em>. This has no <em>visual</em> effect, it just provides hints to -any system-specific input handling tools. -<p> The <em>text</em> argument should be TRUE if this is a position for text -input. -<p> In the Windows version of TQt, this method sets the system caret, -which is used for user Accessibility focus handling. If <em>text</em> -is TRUE, it also sets the IME composition window in Far East Asian -language input systems. -<p> In the X11 version of TQt, if <em>text</em> is TRUE, this method sets the -XIM "spot" point for complex language input handling. -<p> The font <em>f</em> is a rendering hint to the currently active input method. -If <em>f</em> is 0 the widget's font is used. -<p> <p>See also <a href="#microFocusHint-prop">microFocusHint</a>. - -<h3 class=fn>void <a name="setMinimumHeight"></a>TQWidget::setMinimumHeight ( int minh ) -</h3><p>Sets the widget's minimum height to <em>minh</em>. -See the <a href="qwidget.html#minimumHeight-prop">"minimumHeight"</a> property for details. -<h3 class=fn>void <a name="setMinimumSize"></a>TQWidget::setMinimumSize ( const <a href="qsize.html">TQSize</a> & ) -</h3><p>Sets the widget's minimum size. -See the <a href="qwidget.html#minimumSize-prop">"minimumSize"</a> property for details. -<h3 class=fn>void <a name="setMinimumSize-2"></a>TQWidget::setMinimumSize ( int minw, int minh )<tt> [virtual]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This function corresponds to <a href="#setMinimumSize">setMinimumSize</a>( <a href="qsize.html">TQSize</a>(minw, minh) ). -Sets the minimum width to <em>minw</em> and the minimum height to <em>minh</em>. - -<h3 class=fn>void <a name="setMinimumWidth"></a>TQWidget::setMinimumWidth ( int minw ) -</h3><p>Sets the widget's minimum width to <em>minw</em>. -See the <a href="qwidget.html#minimumWidth-prop">"minimumWidth"</a> property for details. -<h3 class=fn>void <a name="setMouseTracking"></a>TQWidget::setMouseTracking ( bool enable )<tt> [virtual slot]</tt> -</h3><p>Sets whether mouse tracking is enabled for the widget to <em>enable</em>. -See the <a href="qwidget.html#mouseTracking-prop">"mouseTracking"</a> property for details. -<h3 class=fn>void <a name="setPalette"></a>TQWidget::setPalette ( const <a href="qpalette.html">TQPalette</a> & )<tt> [virtual]</tt> -</h3><p>Sets the widget's palette. -See the <a href="qwidget.html#palette-prop">"palette"</a> property for details. -<p>Reimplemented in <a href="qcombobox.html#setPalette">TQComboBox</a>, <a href="qscrollbar.html#setPalette">TQScrollBar</a>, and <a href="qslider.html#setPalette">TQSlider</a>. -<h3 class=fn>void <a name="setPalette-2"></a>TQWidget::setPalette ( const <a href="qpalette.html">TQPalette</a> & p, bool ) -</h3> - -<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -<p> Use <a href="#setPalette">setPalette</a>( const <a href="qpalette.html">TQPalette</a>& p ) instead. - -<h3 class=fn>void <a name="setPaletteBackgroundColor"></a>TQWidget::setPaletteBackgroundColor ( const <a href="qcolor.html">TQColor</a> & )<tt> [virtual]</tt> -</h3><p>Sets the background color of the widget. -See the <a href="qwidget.html#paletteBackgroundColor-prop">"paletteBackgroundColor"</a> property for details. -<h3 class=fn>void <a name="setPaletteBackgroundPixmap"></a>TQWidget::setPaletteBackgroundPixmap ( const <a href="qpixmap.html">TQPixmap</a> & )<tt> [virtual]</tt> -</h3><p>Sets the background pixmap of the widget. -See the <a href="qwidget.html#paletteBackgroundPixmap-prop">"paletteBackgroundPixmap"</a> property for details. -<h3 class=fn>void <a name="setPaletteForegroundColor"></a>TQWidget::setPaletteForegroundColor ( const <a href="qcolor.html">TQColor</a> & ) -</h3><p>Sets the foreground color of the widget. -See the <a href="qwidget.html#paletteForegroundColor-prop">"paletteForegroundColor"</a> property for details. -<h3 class=fn>void <a name="setShown"></a>TQWidget::setShown ( bool show )<tt> [slot]</tt> -</h3><p>Sets whether the widget is shown to <em>show</em>. -See the <a href="qwidget.html#shown-prop">"shown"</a> property for details. -<h3 class=fn>void <a name="setSizeIncrement"></a>TQWidget::setSizeIncrement ( const <a href="qsize.html">TQSize</a> & ) -</h3><p>Sets the size increment of the widget. -See the <a href="qwidget.html#sizeIncrement-prop">"sizeIncrement"</a> property for details. -<h3 class=fn>void <a name="setSizeIncrement-2"></a>TQWidget::setSizeIncrement ( int w, int h )<tt> [virtual]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Sets the x (width) size increment to <em>w</em> and the y (height) size -increment to <em>h</em>. - -<h3 class=fn>void <a name="setSizePolicy"></a>TQWidget::setSizePolicy ( <a href="qsizepolicy.html">TQSizePolicy</a> )<tt> [virtual]</tt> -</h3><p>Sets the default layout behavior of the widget. -See the <a href="qwidget.html#sizePolicy-prop">"sizePolicy"</a> property for details. -<h3 class=fn>void <a name="setSizePolicy-2"></a>TQWidget::setSizePolicy ( <a href="qsizepolicy.html#SizeType-enum">TQSizePolicy::SizeType</a> hor, <a href="qsizepolicy.html#SizeType-enum">TQSizePolicy::SizeType</a> ver, bool hfw = FALSE ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Sets the size policy of the widget to <em>hor</em>, <em>ver</em> and <em>hfw</em> -(height for width). -<p> <p>See also <a href="qsizepolicy.html#TQSizePolicy">TQSizePolicy::TQSizePolicy</a>(). - -<h3 class=fn>void <a name="setStyle"></a>TQWidget::setStyle ( <a href="qstyle.html">TQStyle</a> * style ) -</h3> -Sets the widget's GUI style to <em>style</em>. Ownership of the style -object is not transferred. -<p> If no style is set, the widget uses the application's style, -<a href="qapplication.html#style">TQApplication::style</a>() instead. -<p> Setting a widget's style has no effect on existing or future child -widgets. -<p> <b>Warning:</b> This function is particularly useful for demonstration -purposes, where you want to show TQt's styling capabilities. Real -applications should avoid it and use one consistent GUI style -instead. -<p> <p>See also <a href="#style">style</a>(), <a href="qstyle.html">TQStyle</a>, <a href="qapplication.html#style">TQApplication::style</a>(), and <a href="qapplication.html#setStyle">TQApplication::setStyle</a>(). - -<p>Examples: <a href="grapher-nsplugin-example.html#x2778">grapher/grapher.cpp</a> and <a href="progressbar-example.html#x975">progressbar/progressbar.cpp</a>. -<h3 class=fn><a href="qstyle.html">TQStyle</a> * <a name="setStyle-2"></a>TQWidget::setStyle ( const <a href="qstring.html">TQString</a> & style ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Sets the widget's GUI style to <em>style</em> using the <a href="qstylefactory.html">TQStyleFactory</a>. - -<h3 class=fn>void <a name="setTabOrder"></a>TQWidget::setTabOrder ( <a href="qwidget.html">TQWidget</a> * first, <a href="qwidget.html">TQWidget</a> * second )<tt> [static]</tt> -</h3> -Moves the <em>second</em> widget around the ring of focus widgets so -that <a href="focus.html#keyboard-focus">keyboard focus</a> moves from the <em>first</em> widget to the <em>second</em> widget when the Tab key is pressed. -<p> Note that since the tab order of the <em>second</em> widget is changed, -you should order a chain like this: -<p> <pre> - <a href="#setTabOrder">setTabOrder</a>( a, b ); // a to b - <a href="#setTabOrder">setTabOrder</a>( b, c ); // a to b to c - <a href="#setTabOrder">setTabOrder</a>( c, d ); // a to b to c to d - </pre> - -<p> <em>not</em> like this: -<p> <pre> - <a href="#setTabOrder">setTabOrder</a>( c, d ); // c to d WRONG - <a href="#setTabOrder">setTabOrder</a>( a, b ); // a to b AND c to d - <a href="#setTabOrder">setTabOrder</a>( b, c ); // a to b to c, but not c to d - </pre> - -<p> If <em>first</em> or <em>second</em> has a focus proxy, <a href="#setTabOrder">setTabOrder</a>() -correctly substitutes the proxy. -<p> <p>See also <a href="#focusPolicy-prop">focusPolicy</a> and <a href="#setFocusProxy">setFocusProxy</a>(). - -<p>Example: <a href="customlayout-example.html#x1542">customlayout/main.cpp</a>. -<h3 class=fn>void <a name="setUpdatesEnabled"></a>TQWidget::setUpdatesEnabled ( bool enable )<tt> [virtual slot]</tt> -</h3><p>Sets whether updates are enabled to <em>enable</em>. -See the <a href="qwidget.html#updatesEnabled-prop">"updatesEnabled"</a> property for details. -<h3 class=fn>void <a name="setWFlags"></a>TQWidget::setWFlags ( WFlags f )<tt> [virtual protected]</tt> -</h3> - -<p> Sets the widget flags <em>f</em>. -<p> Widget flags are a combination of <a href="qt.html#WidgetFlags-enum">TQt::WidgetFlags</a>. -<p> <p>See also <a href="#testWFlags">testWFlags</a>(), <a href="#getWFlags">getWFlags</a>(), and <a href="#clearWFlags">clearWFlags</a>(). - -<h3 class=fn>void <a name="setWindowOpacity"></a>TQWidget::setWindowOpacity ( double level ) -</h3><p>Sets the level of opacity for the window to <em>level</em>. -See the <a href="qwidget.html#windowOpacity-prop">"windowOpacity"</a> property for details. -<h3 class=fn>void <a name="setWindowState"></a>TQWidget::setWindowState ( uint windowState ) -</h3> - -<p> Sets the <a href="qt.html#WindowState">window state</a> to <em>windowState</em>. The window state is a OR'ed -combination of TQt::WindowState: <a href="qt.html#WindowState-enum">WindowMinimized</a>, <a href="qt.html#WindowState-enum">WindowMaximized</a>, <a href="qt.html#WindowState-enum">WindowFullScreen</a> and <a href="qt.html#WindowState-enum">WindowActive</a>. -<p> If the window is not visible (i.e. <a href="#isVisible">isVisible</a>() returns FALSE), the -window state will take effect when <a href="#show">show</a>() is called. For visible -windows, the change is immediate. For example, to toggle between -full-screen and mormal mode, use the following code: -<p> <pre> - w->setWindowState(w->windowState() ^ WindowFullScreen); - </pre> - -<p> In order to restore and activate a minimized window (while -preserving its maximized and/or full-screen state), use the following: -<p> <pre> - w->setWindowState(w->windowState() & ~WindowMinimized | WindowActive); - </pre> - -<p> Note: On some window systems <a href="qt.html#WindowState-enum">WindowActive</a> is not immediate, and may be -ignored in certain cases. -<p> <p>See also <a href="qt.html#WindowState-enum">TQt::WindowState</a> and <a href="#windowState">windowState</a>(). - -<h3 class=fn>void <a name="show"></a>TQWidget::show ()<tt> [virtual slot]</tt> -</h3> -Shows the widget and its child widgets. -<p> If its size or position has changed, TQt guarantees that a widget -gets move and resize events just before it is shown. -<p> You almost never have to reimplement this function. If you need to -change some settings before a widget is shown, use <a href="#showEvent">showEvent</a>() -instead. If you need to do some delayed initialization use -<a href="#polish">polish</a>(). -<p> <p>See also <a href="#showEvent">showEvent</a>(), <a href="#hide">hide</a>(), <a href="#showMinimized">showMinimized</a>(), <a href="#showMaximized">showMaximized</a>(), <a href="#showNormal">showNormal</a>(), <a href="#visible-prop">visible</a>, and <a href="#polish">polish</a>(). - -<p>Examples: <a href="aclock-example.html#x1215">aclock/main.cpp</a>, <a href="qdialog.html#x2135">life/main.cpp</a>, <a href="popup-example.html#x1628">popup/popup.cpp</a>, <a href="tutorial1-01.html#x2286">t1/main.cpp</a>, <a href="tutorial1-03.html#x2302">t3/main.cpp</a>, <a href="tutorial1-04.html#x2309">t4/main.cpp</a>, and <a href="toplevel-example.html#x2542">toplevel/options.ui.h</a>. -<p>Reimplemented in <a href="qdialog.html#show">TQDialog</a> and <a href="qmenubar.html#show">TQMenuBar</a>. -<h3 class=fn>void <a name="showEvent"></a>TQWidget::showEvent ( <a href="qshowevent.html">TQShowEvent</a> * )<tt> [virtual protected]</tt> -</h3> -This event handler can be reimplemented in a subclass to receive -widget show events. -<p> Non-spontaneous show events are sent to widgets immediately before -they are shown. The spontaneous show events of top-level widgets -are delivered afterwards. -<p> <p>See also <a href="#event">event</a>() and <a href="qshowevent.html">TQShowEvent</a>. - -<p>Example: <a href="qdir-example.html#x1854">qdir/qdir.cpp</a>. -<h3 class=fn>void <a name="showFullScreen"></a>TQWidget::showFullScreen ()<tt> [slot]</tt> -</h3> -Shows the widget in full-screen mode. -<p> Calling this function only affects top-level widgets. -<p> To return from full-screen mode, call <a href="#showNormal">showNormal</a>(). -<p> Full-screen mode works fine under Windows, but has certain -problems under X. These problems are due to limitations of the -ICCCM protocol that specifies the communication between X11 -clients and the window manager. ICCCM simply does not understand -the concept of non-decorated full-screen windows. Therefore, the -best we can do is to request a borderless window and place and -resize it to fill the entire screen. Depending on the window -manager, this may or may not work. The borderless window is -requested using MOTIF hints, which are at least partially -supported by virtually all modern window managers. -<p> An alternative would be to bypass the window manager entirely and -create a window with the WX11BypassWM flag. This has other severe -problems though, like totally broken <a href="focus.html#keyboard-focus">keyboard focus</a> and very -strange effects on desktop changes or when the user raises other -windows. -<p> X11 window managers that follow modern post-ICCCM specifications -support full-screen mode properly. -<p> <p>See also <a href="#showNormal">showNormal</a>(), <a href="#showMaximized">showMaximized</a>(), <a href="#show">show</a>(), <a href="#hide">hide</a>(), and <a href="#visible-prop">visible</a>. - -<h3 class=fn>void <a name="showMaximized"></a>TQWidget::showMaximized ()<tt> [virtual slot]</tt> -</h3> -Shows the widget maximized. -<p> Calling this function only affects <a href="#isTopLevel">top-level - widgets</a>. -<p> On X11, this function may not work properly with certain window -managers. See the <a href="geometry.html">Window Geometry - documentation</a> for an explanation. -<p> <p>See also <a href="#setWindowState">setWindowState</a>(), <a href="#showNormal">showNormal</a>(), <a href="#showMinimized">showMinimized</a>(), <a href="#show">show</a>(), <a href="#hide">hide</a>(), and <a href="#visible-prop">visible</a>. - -<p>Examples: <a href="canvas-example.html#x2968">canvas/main.cpp</a>, <a href="helpviewer-example.html#x1045">helpviewer/main.cpp</a>, <a href="mdi-example.html#x2087">mdi/application.cpp</a>, <a href="qwerty-example.html#x422">qwerty/main.cpp</a>, <a href="qwerty-example.html#x413">qwerty/qwerty.cpp</a>, and <a href="scribble-example.html#x960">scribble/main.cpp</a>. -<h3 class=fn>void <a name="showMinimized"></a>TQWidget::showMinimized ()<tt> [virtual slot]</tt> -</h3> -Shows the widget minimized, as an icon. -<p> Calling this function only affects <a href="#isTopLevel">top-level - widgets</a>. -<p> <p>See also <a href="#showNormal">showNormal</a>(), <a href="#showMaximized">showMaximized</a>(), <a href="#show">show</a>(), <a href="#hide">hide</a>(), <a href="#visible-prop">visible</a>, and <a href="#minimized-prop">minimized</a>. - -<h3 class=fn>void <a name="showNormal"></a>TQWidget::showNormal ()<tt> [virtual slot]</tt> -</h3> -Restores the widget after it has been maximized or minimized. -<p> Calling this function only affects <a href="#isTopLevel">top-level - widgets</a>. -<p> <p>See also <a href="#setWindowState">setWindowState</a>(), <a href="#showMinimized">showMinimized</a>(), <a href="#showMaximized">showMaximized</a>(), <a href="#show">show</a>(), <a href="#hide">hide</a>(), and <a href="#visible-prop">visible</a>. - -<p>Example: <a href="mdi-example.html#x2088">mdi/application.cpp</a>. -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="size"></a>TQWidget::size () const -</h3><p>Returns the size of the widget excluding any window frame. -See the <a href="qwidget.html#size-prop">"size"</a> property for details. -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="sizeHint"></a>TQWidget::sizeHint () const<tt> [virtual]</tt> -</h3><p>Returns the recommended size for the widget. -See the <a href="qwidget.html#sizeHint-prop">"sizeHint"</a> property for details. -<p>Reimplemented in <a href="qsizegrip.html#sizeHint">TQSizeGrip</a>. -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="sizeIncrement"></a>TQWidget::sizeIncrement () const -</h3><p>Returns the size increment of the widget. -See the <a href="qwidget.html#sizeIncrement-prop">"sizeIncrement"</a> property for details. -<h3 class=fn><a href="qsizepolicy.html">TQSizePolicy</a> <a name="sizePolicy"></a>TQWidget::sizePolicy () const<tt> [virtual]</tt> -</h3><p>Returns the default layout behavior of the widget. -See the <a href="qwidget.html#sizePolicy-prop">"sizePolicy"</a> property for details. -<h3 class=fn>void <a name="stackUnder"></a>TQWidget::stackUnder ( <a href="qwidget.html">TQWidget</a> * w )<tt> [slot]</tt> -</h3> -Places the widget under <em>w</em> in the parent widget's stack. -<p> To make this work, the widget itself and <em>w</em> must be siblings. -<p> <p>See also <a href="#raise">raise</a>() and <a href="#lower">lower</a>(). - -<h3 class=fn><a href="qstyle.html">TQStyle</a> & <a name="style"></a>TQWidget::style () const -</h3> -Returns the GUI style for this widget -<p> <p>See also <a href="#setStyle">TQWidget::setStyle</a>(), <a href="qapplication.html#setStyle">TQApplication::setStyle</a>(), and <a href="qapplication.html#style">TQApplication::style</a>(). - -<h3 class=fn>void <a name="styleChange"></a>TQWidget::styleChange ( <a href="qstyle.html">TQStyle</a> & oldStyle )<tt> [virtual protected]</tt> -</h3> -This virtual function is called when the style of the widgets -changes. <em>oldStyle</em> is the previous GUI style; you can get the -new style from <a href="#style">style</a>(). -<p> Reimplement this function if your widget needs to know when its -GUI style changes. You will almost certainly need to update the -widget using <a href="#update">update</a>(). -<p> The default implementation updates the widget including its -geometry. -<p> <p>See also <a href="qapplication.html#setStyle">TQApplication::setStyle</a>(), <a href="#style">style</a>(), <a href="#update">update</a>(), and <a href="#updateGeometry">updateGeometry</a>(). - -<h3 class=fn>void <a name="tabletEvent"></a>TQWidget::tabletEvent ( <a href="qtabletevent.html">TQTabletEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler, for event <em>e</em>, can be reimplemented in a -subclass to receive tablet events for the widget. -<p> If you reimplement this handler, it is very important that you -<a href="qtabletevent.html">ignore()</a> the event if you do not handle -it, so that the widget's parent can interpret it. -<p> The default implementation ignores the event. -<p> <p>See also <a href="qtabletevent.html#ignore">TQTabletEvent::ignore</a>(), <a href="qtabletevent.html#accept">TQTabletEvent::accept</a>(), <a href="#event">event</a>(), and <a href="qtabletevent.html">TQTabletEvent</a>. - -<h3 class=fn>WFlags <a name="testWFlags"></a>TQWidget::testWFlags ( WFlags f ) const -</h3> - -<p> Returns the bitwise AND of the widget flags and <em>f</em>. -<p> Widget flags are a combination of <a href="qt.html#WidgetFlags-enum">TQt::WidgetFlags</a>. -<p> If you want to test for the presence of multiple flags (or -composite flags such as <a href="qt.html#WidgetFlags-enum">WStyle_Splash</a>), test the -return value for equality against the argument. For example: -<p> <pre> - int flags = WStyle_Tool | WStyle_NoBorder; - if ( <a href="#testWFlags">testWFlags</a>(flags) ) - ... // WStyle_Tool or WStyle_NoBorder or both are set - if ( <a href="#testWFlags">testWFlags</a>(flags) == flags ) - ... // both WStyle_Tool and WStyle_NoBorder are set - </pre> - -<p> <p>See also <a href="#getWFlags">getWFlags</a>(), <a href="#setWFlags">setWFlags</a>(), and <a href="#clearWFlags">clearWFlags</a>(). - -<h3 class=fn><a href="qwidget.html">TQWidget</a> * <a name="topLevelWidget"></a>TQWidget::topLevelWidget () const -</h3> -Returns the top-level widget for this widget, i.e. the next -ancestor widget that has (or could have) a window-system frame. -<p> If the widget is a top-level, the widget itself is returned. -<p> Typical usage is changing the window caption: -<p> <pre> - aWidget->topLevelWidget()->setCaption( "New Caption" ); - </pre> - -<p> <p>See also <a href="#isTopLevel-prop">isTopLevel</a>. - -<h3 class=fn>void <a name="unsetCursor"></a>TQWidget::unsetCursor ()<tt> [virtual]</tt> -</h3><p>Resets the cursor shape for this widget. -See the <a href="qwidget.html#cursor-prop">"cursor"</a> property for details. -<h3 class=fn>void <a name="unsetFont"></a>TQWidget::unsetFont () -</h3><p>Resets the font currently set for the widget. -See the <a href="qwidget.html#font-prop">"font"</a> property for details. -<h3 class=fn>void <a name="unsetPalette"></a>TQWidget::unsetPalette () -</h3><p>Resets the widget's palette. -See the <a href="qwidget.html#palette-prop">"palette"</a> property for details. -<h3 class=fn>void <a name="update"></a>TQWidget::update ()<tt> [slot]</tt> -</h3> -Updates the widget unless updates are disabled or the widget is -hidden. -<p> This function does not cause an immediate repaint; instead it -schedules a paint event for processing when TQt returns to the main -event loop. This permits TQt to optimize for more speed and less -flicker than a call to <a href="#repaint">repaint</a>() does. -<p> Calling <a href="#update">update</a>() several times normally results in just one -<a href="#paintEvent">paintEvent</a>() call. -<p> TQt normally erases the widget's area before the paintEvent() call. -If the <a href="qt.html#WidgetFlags-enum">WRepaintNoErase</a> widget flag is set, the widget is -responsible for painting all its pixels itself. -<p> <p>See also <a href="#repaint">repaint</a>(), <a href="#paintEvent">paintEvent</a>(), <a href="#updatesEnabled-prop">updatesEnabled</a>, <a href="#erase">erase</a>(), and <a href="#setWFlags">setWFlags</a>(). - -<p>Examples: <a href="desktop-example.html#x1763">desktop/desktop.cpp</a> and <a href="scrollview-example.html#x662">scrollview/scrollview.cpp</a>. -<h3 class=fn>void <a name="update-2"></a>TQWidget::update ( int x, int y, int w, int h )<tt> [slot]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Updates a rectangle (<em>x</em>, <em>y</em>, <em>w</em>, <em>h</em>) inside the widget -unless updates are disabled or the widget is hidden. -<p> This function does not cause an immediate repaint; instead it -schedules a paint event for processing when TQt returns to the main -event loop. This permits TQt to optimize for more speed and less -flicker and a call to <a href="#repaint">repaint</a>() does. -<p> Calling <a href="#update">update</a>() several times normally results in just one -<a href="#paintEvent">paintEvent</a>() call. -<p> If <em>w</em> is negative, it is replaced with <tt>width() - x</tt>. If <em>h</em> -is negative, it is replaced width <tt>height() - y</tt>. -<p> TQt normally erases the specified area before the paintEvent() -call. If the <a href="qt.html#WidgetFlags-enum">WRepaintNoErase</a> widget flag is set, the widget is -responsible for painting all its pixels itself. -<p> <p>See also <a href="#repaint">repaint</a>(), <a href="#paintEvent">paintEvent</a>(), <a href="#updatesEnabled-prop">updatesEnabled</a>, and <a href="#erase">erase</a>(). - -<h3 class=fn>void <a name="update-3"></a>TQWidget::update ( const <a href="qrect.html">TQRect</a> & r )<tt> [slot]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Updates a rectangle <em>r</em> inside the widget unless updates are -disabled or the widget is hidden. -<p> This function does not cause an immediate repaint; instead it -schedules a paint event for processing when TQt returns to the main -event loop. This permits TQt to optimize for more speed and less -flicker and a call to <a href="#repaint">repaint</a>() does. -<p> Calling <a href="#update">update</a>() several times normally results in just one -<a href="#paintEvent">paintEvent</a>() call. - -<h3 class=fn>void <a name="updateGeometry"></a>TQWidget::updateGeometry () -</h3> -Notifies the layout system that this widget has changed and may -need to change geometry. -<p> Call this function if the <a href="#sizeHint">sizeHint</a>() or <a href="#sizePolicy">sizePolicy</a>() have changed. -<p> For explicitly hidden widgets, <a href="#updateGeometry">updateGeometry</a>() is a no-op. The -layout system will be notified as soon as the widget is shown. - -<h3 class=fn>void <a name="updateMask"></a>TQWidget::updateMask ()<tt> [virtual protected]</tt> -</h3> -This function can be reimplemented in a subclass to support -transparent widgets. It should be called whenever a widget changes -state in a way that means that the shape mask must be recalculated. -<p> <p>See also <a href="#autoMask-prop">autoMask</a>, <a href="#setMask">setMask</a>(), and <a href="#clearMask">clearMask</a>(). - -<h3 class=fn><a href="qrect.html">TQRect</a> <a name="visibleRect"></a>TQWidget::visibleRect () const -</h3><p>Returns the visible rectangle. -See the <a href="qwidget.html#visibleRect-prop">"visibleRect"</a> property for details. -<h3 class=fn>void <a name="wheelEvent"></a>TQWidget::wheelEvent ( <a href="qwheelevent.html">TQWheelEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler, for event <em>e</em>, can be reimplemented in a -subclass to receive wheel events for the widget. -<p> If you reimplement this handler, it is very important that you -<a href="qwheelevent.html">ignore()</a> the event if you do not handle -it, so that the widget's parent can interpret it. -<p> The default implementation ignores the event. -<p> <p>See also <a href="qwheelevent.html#ignore">TQWheelEvent::ignore</a>(), <a href="qwheelevent.html#accept">TQWheelEvent::accept</a>(), <a href="#event">event</a>(), and <a href="qwheelevent.html">TQWheelEvent</a>. - -<h3 class=fn>int <a name="width"></a>TQWidget::width () const -</h3><p>Returns the width of the widget excluding any window frame. -See the <a href="qwidget.html#width-prop">"width"</a> property for details. -<h3 class=fn>bool <a name="winEvent"></a>TQWidget::winEvent ( MSG * )<tt> [virtual protected]</tt> -</h3> -This special event handler can be reimplemented in a subclass to -receive native Windows events. -<p> In your reimplementation of this function, if you want to stop the -event being handled by TQt, return TRUE. If you return FALSE, this -native event is passed back to TQt, which translates the event into -a TQt event and sends it to the widget. -<p> <b>Warning:</b> This function is not portable. -<p> <p>See also <a href="qapplication.html#winEventFilter">TQApplication::winEventFilter</a>(). - -<h3 class=fn>WId <a name="winId"></a>TQWidget::winId () const -</h3> - -<p> Returns the window system identifier of the widget. -<p> Portable in principle, but if you use it you are probably about to -do something non-portable. Be careful. -<p> <p>See also <a href="#find">find</a>(). - -<h3 class=fn>void <a name="windowActivationChange"></a>TQWidget::windowActivationChange ( bool oldActive )<tt> [virtual protected]</tt> -</h3> - -<p> This virtual function is called for a widget when its window is -activated or deactivated by the window system. <em>oldActive</em> is the -previous state; you can get the new setting from <a href="#isActiveWindow">isActiveWindow</a>(). -<p> Reimplement this function if your widget needs to know when its -window becomes activated or deactivated. -<p> The default implementation updates the visible part of the widget -if the inactive and the active colorgroup are different for colors -other than the highlight and link colors. -<p> <p>See also <a href="#setActiveWindow">setActiveWindow</a>(), <a href="#isActiveWindow-prop">isActiveWindow</a>, <a href="#update">update</a>(), and <a href="#palette-prop">palette</a>. - -<h3 class=fn>double <a name="windowOpacity"></a>TQWidget::windowOpacity () const -</h3><p>Returns the level of opacity for the window. -See the <a href="qwidget.html#windowOpacity-prop">"windowOpacity"</a> property for details. -<h3 class=fn>uint <a name="windowState"></a>TQWidget::windowState () const -</h3> Returns the current <a href="qt.html#WindowState">window state</a>. The window state is a OR'ed -combination of TQt::WindowState: <a href="qt.html#WindowState-enum">WindowMinimized</a>, <a href="qt.html#WindowState-enum">WindowMaximized</a>, <a href="qt.html#WindowState-enum">WindowFullScreen</a> and <a href="qt.html#WindowState-enum">WindowActive</a>. -<p> <p>See also <a href="qt.html#WindowState-enum">TQt::WindowState</a> and <a href="#setWindowState">setWindowState</a>(). - -<h3 class=fn>int <a name="x"></a>TQWidget::x () const -</h3><p>Returns the x coordinate of the widget relative to its parent including any window frame. -See the <a href="qwidget.html#x-prop">"x"</a> property for details. -<h3 class=fn>bool <a name="x11Event"></a>TQWidget::x11Event ( XEvent * )<tt> [virtual protected]</tt> -</h3> -This special event handler can be reimplemented in a subclass to -receive native X11 events. -<p> In your reimplementation of this function, if you want to stop the -event being handled by TQt, return TRUE. If you return FALSE, this -native event is passed back to TQt, which translates the event into -a TQt event and sends it to the widget. -<p> <b>Warning:</b> This function is not portable. -<p> <p>See also <a href="qapplication.html#x11EventFilter">TQApplication::x11EventFilter</a>(). - -<p>Reimplemented in <a href="qxtwidget.html#x11Event">TQXtWidget</a>. -<h3 class=fn>int <a name="y"></a>TQWidget::y () const -</h3><p>Returns the y coordinate of the widget relative to its parent and including any window frame. -See the <a href="qwidget.html#y-prop">"y"</a> property for details. -<hr><h2>Property Documentation</h2> -<h3 class=fn>bool <a name="acceptDrops-prop"></a>acceptDrops</h3> -<p>This property holds whether drop events are enabled for this widget. -<p>Setting this property to TRUE announces to the system that this -widget <em>may</em> be able to accept drop events. -<p> If the widget is the desktop (<a href="#isDesktop">TQWidget::isDesktop</a>()), this may -fail if another application is using the desktop; you can call -<a href="#acceptDrops">acceptDrops</a>() to test if this occurs. -<p> <b>Warning:</b> -Do not modify this property in a Drag&Drop event handler. - -<p>Set this property's value with <a href="#setAcceptDrops">setAcceptDrops</a>() and get this property's value with <a href="#acceptDrops">acceptDrops</a>(). -<h3 class=fn>bool <a name="autoMask-prop"></a>autoMask</h3> -<p>This property holds whether the auto mask feature is enabled for the widget. -<p>Transparent widgets use a mask to define their visible region. -TQWidget has some built-in support to make the task of -recalculating the mask easier. When setting auto mask to TRUE, -<a href="#updateMask">updateMask</a>() will be called whenever the widget is resized or -changes its focus state. Note that you must reimplement -updateMask() (which should include a call to <a href="#setMask">setMask</a>()) or nothing -will happen. -<p> Note: when you re-implement <a href="#resizeEvent">resizeEvent</a>(), <a href="#focusInEvent">focusInEvent</a>() or -<a href="#focusOutEvent">focusOutEvent</a>() in your custom widgets and still want to ensure -that the auto mask calculation works, you should add: -<p> <pre> - if ( <a href="#autoMask">autoMask</a>() ) - <a href="#updateMask">updateMask</a>(); - </pre> - -<p> at the end of your event handlers. This is true for all member -functions that change the appearance of the widget in a way that -requires a recalculation of the mask. -<p> While being a technically appealing concept, masks have a big -drawback: when using complex masks that cannot be expressed easily -with relatively simple regions, they can be very slow on some -window systems. The classic example is a transparent label. The -complex shape of its contents makes it necessary to represent its -mask by a bitmap, which consumes both memory and time. If all you -want is to blend the background of several neighboring widgets -together seamlessly, you will probably want to use -<a href="#setBackgroundOrigin">setBackgroundOrigin</a>() rather than a mask. -<p> <p>See also <a href="#updateMask">updateMask</a>(), <a href="#setMask">setMask</a>(), <a href="#clearMask">clearMask</a>(), and <a href="#backgroundOrigin-prop">backgroundOrigin</a>. - -<p>Set this property's value with <a href="#setAutoMask">setAutoMask</a>() and get this property's value with <a href="#autoMask">autoMask</a>(). -<h3 class=fn><a href="qbrush.html">TQBrush</a> <a name="backgroundBrush-prop"></a>backgroundBrush</h3> -<p>This property holds the widget's background brush. -<p>The background brush depends on a widget's palette and its -background mode. -<p> <p>See also <a href="#backgroundColor">backgroundColor</a>(), <a href="#backgroundPixmap">backgroundPixmap</a>(), <a href="#eraseColor">eraseColor</a>(), <a href="#palette-prop">palette</a>, and <a href="qapplication.html#setPalette">TQApplication::setPalette</a>(). - -<p>Get this property's value with <a href="#backgroundBrush">backgroundBrush</a>(). -<h3 class=fn><a href="qt.html#BackgroundMode-enum">BackgroundMode</a> <a name="backgroundMode-prop"></a>backgroundMode</h3> -<p>This property holds the color role used for painting the background of the widget. -<p>setPaletteBackgroundColor() reads this property to determine which -entry of the <a href="#palette-prop">palette</a> to set. -<p> For most widgets the default suffices (<a href="qt.html#BackgroundMode-enum">PaletteBackground</a>, -typically gray), but some need to use <a href="qt.html#BackgroundMode-enum">PaletteBase</a> (the -background color for text output, typically white) or another -role. -<p> <a href="qlistbox.html">TQListBox</a>, which is "sunken" and uses the base color to contrast -with its environment, does this in its constructor: -<p> <pre> - <a href="#setBackgroundMode">setBackgroundMode</a>( <a href="qt.html#BackgroundMode-enum">PaletteBase</a> ); - </pre> - -<p> You will never need to set the background mode of a built-in -widget in TQt, but you might consider setting it in your custom -widgets, so that <a href="#setPaletteBackgroundColor">setPaletteBackgroundColor</a>() works as expected. -<p> Note that two of the BackgroundMode values make no sense for -<a href="#setBackgroundMode">setBackgroundMode</a>(), namely <a href="qt.html#BackgroundMode-enum">FixedPixmap</a> and <a href="qt.html#BackgroundMode-enum">FixedColor</a>. You -must call <a href="#setBackgroundPixmap">setBackgroundPixmap</a>() and setPaletteBackgroundColor() -instead. - -<p>Set this property's value with <a href="#setBackgroundMode">setBackgroundMode</a>() and get this property's value with <a href="#backgroundMode">backgroundMode</a>(). -<h3 class=fn><a href="qwidget.html#BackgroundOrigin-enum">BackgroundOrigin</a> <a name="backgroundOrigin-prop"></a>backgroundOrigin</h3> -<p>This property holds the origin of the widget's background. -<p>The origin is either WidgetOrigin (the default), ParentOrigin, -WindowOrigin or AncestorOrigin. -<p> This only makes a difference if the widget has a background -pixmap, in which case positioning matters. Using <a href="#BackgroundOrigin-enum">WindowOrigin</a> -for several neighboring widgets makes the background blend -together seamlessly. <a href="#BackgroundOrigin-enum">AncestorOrigin</a> allows blending backgrounds -seamlessly when an ancestor of the widget has an origin other than -<a href="#BackgroundOrigin-enum">WindowOrigin</a>. -<p> <p>See also <a href="#backgroundPixmap">backgroundPixmap</a>() and <a href="#backgroundMode-prop">backgroundMode</a>. - -<p>Set this property's value with <a href="#setBackgroundOrigin">setBackgroundOrigin</a>() and get this property's value with <a href="#backgroundOrigin">backgroundOrigin</a>(). -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="baseSize-prop"></a>baseSize</h3> -<p>This property holds the base size of the widget. -<p>The base size is used to calculate a proper widget size if the -widget defines <a href="#sizeIncrement">sizeIncrement</a>(). -<p> <p>See also <a href="#sizeIncrement-prop">sizeIncrement</a>. - -<p>Set this property's value with <a href="#setBaseSize">setBaseSize</a>() and get this property's value with <a href="#baseSize">baseSize</a>(). -<h3 class=fn><a href="qstring.html">TQString</a> <a name="caption-prop"></a>caption</h3> -<p>This property holds the window caption (title). -<p>This property only makes sense for top-level widgets. If no -caption has been set, the caption is <a href="qstring.html#TQString-null">TQString::null</a>. -<p> <p>See also <a href="#icon-prop">icon</a> and <a href="#iconText-prop">iconText</a>. - -<p>Set this property's value with <a href="#setCaption">setCaption</a>() and get this property's value with <a href="#caption">caption</a>(). -<h3 class=fn><a href="qrect.html">TQRect</a> <a name="childrenRect-prop"></a>childrenRect</h3> -<p>This property holds the bounding rectangle of the widget's children. -<p>Hidden children are excluded. -<p> <p>See also <a href="#childrenRegion-prop">childrenRegion</a> and <a href="#geometry-prop">geometry</a>. - -<p>Get this property's value with <a href="#childrenRect">childrenRect</a>(). -<h3 class=fn><a href="qregion.html">TQRegion</a> <a name="childrenRegion-prop"></a>childrenRegion</h3> -<p>This property holds the combined region occupied by the widget's children. -<p>Hidden children are excluded. -<p> <p>See also <a href="#childrenRect-prop">childrenRect</a> and <a href="#geometry-prop">geometry</a>. - -<p>Get this property's value with <a href="#childrenRegion">childrenRegion</a>(). -<h3 class=fn><a href="qcolorgroup.html">TQColorGroup</a> <a name="colorGroup-prop"></a>colorGroup</h3> -<p>This property holds the current color group of the widget palette. -<p>The color group is determined by the state of the widget. A -disabled widget has the <a href="qpalette.html#disabled">TQPalette::disabled</a>() color group, a widget -with <a href="focus.html#keyboard-focus">keyboard focus</a> has the <a href="qpalette.html#active">TQPalette::active</a>() color group, and an -inactive widget has the <a href="qpalette.html#inactive">TQPalette::inactive</a>() color group. -<p> <p>See also <a href="#palette-prop">palette</a>. - -<p>Get this property's value with <a href="#colorGroup">colorGroup</a>(). -<h3 class=fn><a href="qcursor.html">TQCursor</a> <a name="cursor-prop"></a>cursor</h3> -<p>This property holds the cursor shape for this widget. -<p>The mouse cursor will assume this shape when it's over this -widget. See the <a href="qt.html#CursorShape-enum">list of predefined cursor - objects</a> for a range of useful shapes. -<p> An editor widget might use an I-beam cursor: -<pre> - <a href="#setCursor">setCursor</a>( <a href="qt.html#CursorShape-enum">IbeamCursor</a> ); - </pre> - -<p> If no cursor has been set, or after a call to <a href="#unsetCursor">unsetCursor</a>(), the -parent's cursor is used. The function unsetCursor() has no effect -on top-level widgets. -<p> <p>See also <a href="qapplication.html#setOverrideCursor">TQApplication::setOverrideCursor</a>(). - -<p>Set this property's value with <a href="#setCursor">setCursor</a>(), get this property's value with <a href="#cursor">cursor</a>(), and reset this property's value with <a href="#unsetCursor">unsetCursor</a>(). -<h3 class=fn>bool <a name="customWhatsThis-prop"></a>customWhatsThis</h3> -<p>This property holds whether the widget wants to handle What's This help manually. -<p>The default implementation of <a href="#customWhatsThis">customWhatsThis</a>() returns FALSE, -which means the widget will not receive any events in Whats This -mode. -<p> The widget may leave What's This mode by calling -<a href="qwhatsthis.html#leaveWhatsThisMode">TQWhatsThis::leaveWhatsThisMode</a>(), with or without actually -displaying any help text. -<p> You can also reimplement customWhatsThis() if your widget is a -"passive interactor" supposed to work under all circumstances. -Simply don't call TQWhatsThis::leaveWhatsThisMode() in that case. -<p> <p>See also <a href="qwhatsthis.html#inWhatsThisMode">TQWhatsThis::inWhatsThisMode</a>() and <a href="qwhatsthis.html#leaveWhatsThisMode">TQWhatsThis::leaveWhatsThisMode</a>(). - -<p>Get this property's value with <a href="#customWhatsThis">customWhatsThis</a>(). -<h3 class=fn>bool <a name="enabled-prop"></a>enabled</h3> -<p>This property holds whether the widget is enabled. -<p>An enabled widget receives keyboard and mouse events; a disabled -widget does not. In fact, an enabled widget only receives keyboard -events when it is in focus. -<p> Some widgets display themselves differently when they are -disabled. For example a button might draw its label grayed out. If -your widget needs to know when it becomes enabled or disabled, you -can reimplement the <a href="#enabledChange">enabledChange</a>() function. -<p> Disabling a widget implicitly disables all its children. Enabling -respectively enables all child widgets unless they have been -explicitly disabled. -<p> <p>See also <a href="#enabled-prop">enabled</a>, <a href="#isEnabledTo">isEnabledTo</a>(), <a href="qkeyevent.html">TQKeyEvent</a>, <a href="qmouseevent.html">TQMouseEvent</a>, and <a href="#enabledChange">enabledChange</a>(). - -<p>Set this property's value with <a href="#setEnabled">setEnabled</a>() and get this property's value with <a href="#isEnabled">isEnabled</a>(). -<h3 class=fn>bool <a name="focus-prop"></a>focus</h3> -<p>This property holds whether this widget (or its focus proxy) has the keyboard input focus. -<p>Effectively equivalent to <tt>qApp->focusWidget() == this</tt>. -<p> <p>See also <a href="#setFocus">setFocus</a>(), <a href="#clearFocus">clearFocus</a>(), <a href="#focusPolicy-prop">focusPolicy</a>, and <a href="qapplication.html#focusWidget">TQApplication::focusWidget</a>(). - -<p>Get this property's value with <a href="#hasFocus">hasFocus</a>(). -<h3 class=fn>bool <a name="focusEnabled-prop"></a>focusEnabled</h3> -<p>This property holds whether the widget accepts <a href="focus.html#keyboard-focus">keyboard focus</a>. -<p>Keyboard focus is initially disabled (i.e. <a href="#focusPolicy">focusPolicy</a>() == -<a href="#FocusPolicy-enum">TQWidget::NoFocus</a>). -<p> You must enable keyboard focus for a widget if it processes -keyboard events. This is normally done from the widget's -constructor. For instance, the <a href="qlineedit.html">TQLineEdit</a> constructor calls -<a href="#setFocusPolicy">setFocusPolicy</a>(TQWidget::StrongFocus). -<p> <p>See also <a href="#focusPolicy-prop">focusPolicy</a>, <a href="#focusInEvent">focusInEvent</a>(), <a href="#focusOutEvent">focusOutEvent</a>(), <a href="#keyPressEvent">keyPressEvent</a>(), <a href="#keyReleaseEvent">keyReleaseEvent</a>(), and <a href="#enabled-prop">enabled</a>. - -<p>Get this property's value with <a href="#isFocusEnabled">isFocusEnabled</a>(). -<h3 class=fn><a href="qwidget.html#FocusPolicy-enum">FocusPolicy</a> <a name="focusPolicy-prop"></a>focusPolicy</h3> -<p>This property holds the way the widget accepts <a href="focus.html#keyboard-focus">keyboard focus</a>. -<p>The policy is <a href="#FocusPolicy-enum">TQWidget::TabFocus</a> if the widget accepts keyboard -focus by tabbing, <a href="#FocusPolicy-enum">TQWidget::ClickFocus</a> if the widget accepts -focus by clicking, <a href="#FocusPolicy-enum">TQWidget::StrongFocus</a> if it accepts both, and -<a href="#FocusPolicy-enum">TQWidget::NoFocus</a> (the default) if it does not accept focus at -all. -<p> You must enable keyboard focus for a widget if it processes -keyboard events. This is normally done from the widget's -constructor. For instance, the <a href="qlineedit.html">TQLineEdit</a> constructor calls -<a href="#setFocusPolicy">setFocusPolicy</a>(TQWidget::StrongFocus). -<p> <p>See also <a href="#focusEnabled-prop">focusEnabled</a>, <a href="#focusInEvent">focusInEvent</a>(), <a href="#focusOutEvent">focusOutEvent</a>(), <a href="#keyPressEvent">keyPressEvent</a>(), <a href="#keyReleaseEvent">keyReleaseEvent</a>(), and <a href="#enabled-prop">enabled</a>. - -<p>Set this property's value with <a href="#setFocusPolicy">setFocusPolicy</a>() and get this property's value with <a href="#focusPolicy">focusPolicy</a>(). -<h3 class=fn><a href="qfont.html">TQFont</a> <a name="font-prop"></a>font</h3> -<p>This property holds the font currently set for the widget. -<p>The <a href="#fontInfo">fontInfo</a>() function reports the actual font that is being used -by the widget. -<p> As long as no special font has been set, or after <a href="#unsetFont">unsetFont</a>() is -called, this is either a special font for the widget class, the -parent's font or (if this widget is a top level widget), the -default application font. -<p> This code fragment sets a 12 point helvetica bold font: -<pre> - <a href="qfont.html">TQFont</a> f( "Helvetica", 12, TQFont::Bold ); - <a href="#setFont">setFont</a>( f ); - </pre> - -<p> In addition to setting the font, <a href="#setFont">setFont</a>() informs all children -about the change. -<p> <p>See also <a href="#fontChange">fontChange</a>(), <a href="#fontInfo">fontInfo</a>(), <a href="#fontMetrics">fontMetrics</a>(), and <a href="#ownFont-prop">ownFont</a>. - -<p>Set this property's value with <a href="#setFont">setFont</a>(), get this property's value with <a href="#font">font</a>(), and reset this property's value with <a href="#unsetFont">unsetFont</a>(). -<h3 class=fn><a href="qrect.html">TQRect</a> <a name="frameGeometry-prop"></a>frameGeometry</h3> -<p>This property holds geometry of the widget relative to its parent including any window frame. -<p>See the <a href="geometry.html">Window Geometry documentation</a> -for an overview of geometry issues with top-level widgets. -<p> <p>See also <a href="#geometry-prop">geometry</a>, <a href="#x-prop">x</a>, <a href="#y-prop">y</a>, and <a href="#pos-prop">pos</a>. - -<p>Get this property's value with <a href="#frameGeometry">frameGeometry</a>(). -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="frameSize-prop"></a>frameSize</h3> -<p>This property holds the size of the widget including any window frame. -<p> -<p>Get this property's value with <a href="#frameSize">frameSize</a>(). -<h3 class=fn>bool <a name="fullScreen-prop"></a>fullScreen</h3> -<p>This property holds whether the widget is full screen. -<p>Get this property's value with <a href="#isFullScreen">isFullScreen</a>(). -<p><p>See also <a href="#windowState">windowState</a>(), <a href="#minimized-prop">minimized</a>, and <a href="#maximized-prop">maximized</a>. - -<h3 class=fn><a href="qrect.html">TQRect</a> <a name="geometry-prop"></a>geometry</h3> -<p>This property holds the geometry of the widget relative to its parent and excluding the window frame. -<p>When changing the geometry, the widget, if visible, receives a -move event (<a href="#moveEvent">moveEvent</a>()) and/or a resize event (<a href="#resizeEvent">resizeEvent</a>()) -immediately. If the widget is not currently visible, it is -guaranteed to receive appropriate events before it is shown. -<p> The size component is adjusted if it lies outside the range -defined by <a href="#minimumSize">minimumSize</a>() and <a href="#maximumSize">maximumSize</a>(). -<p> <a href="#setGeometry">setGeometry</a>() is virtual, and all other overloaded setGeometry() -implementations in TQt call it. -<p> <b>Warning:</b> Calling setGeometry() inside resizeEvent() or moveEvent() -can lead to infinite recursion. -<p> See the <a href="geometry.html">Window Geometry documentation</a> -for an overview of top-level widget geometry. -<p> <p>See also <a href="#frameGeometry-prop">frameGeometry</a>, <a href="#rect-prop">rect</a>, <a href="#pos-prop">pos</a>, <a href="#size-prop">size</a>, <a href="#moveEvent">moveEvent</a>(), <a href="#resizeEvent">resizeEvent</a>(), <a href="#minimumSize-prop">minimumSize</a>, and <a href="#maximumSize-prop">maximumSize</a>. - -<p>Set this property's value with <a href="#setGeometry">setGeometry</a>() and get this property's value with <a href="#geometry">geometry</a>(). -<h3 class=fn>int <a name="height-prop"></a>height</h3> -<p>This property holds the height of the widget excluding any window frame. -<p>See the <a href="geometry.html">Window Geometry documentation</a> -for an overview of top-level widget geometry. -<p> <p>See also <a href="#geometry-prop">geometry</a>, <a href="#width-prop">width</a>, and <a href="#size-prop">size</a>. - -<p>Get this property's value with <a href="#height">height</a>(). -<h3 class=fn>bool <a name="hidden-prop"></a>hidden</h3> -<p>This property holds whether the widget is explicitly hidden. -<p>If FALSE, the widget is visible or would become visible if all its -ancestors became visible. -<p> <p>See also <a href="#hide">hide</a>(), <a href="#show">show</a>(), <a href="#visible-prop">visible</a>, <a href="#isVisibleTo">isVisibleTo</a>(), and <a href="#shown-prop">shown</a>. - -<p>Set this property's value with <a href="#setHidden">setHidden</a>() and get this property's value with <a href="#isHidden">isHidden</a>(). -<h3 class=fn><a href="qpixmap.html">TQPixmap</a> <a name="icon-prop"></a>icon</h3> -<p>This property holds the widget's icon. -<p>This property only makes sense for top-level widgets. If no icon -has been set, <a href="#icon">icon</a>() returns 0. -<p> <p>See also <a href="#iconText-prop">iconText</a>, <a href="#caption-prop">caption</a>, and <a href="appicon.html">Setting the Application Icon</a>. - -<p>Set this property's value with <a href="#setIcon">setIcon</a>() and get this property's value with <a href="#icon">icon</a>(). -<h3 class=fn><a href="qstring.html">TQString</a> <a name="iconText-prop"></a>iconText</h3> -<p>This property holds the widget's icon text. -<p>This property only makes sense for top-level widgets. If no icon -text has been set, this functions returns <a href="qstring.html#TQString-null">TQString::null</a>. -<p> <p>See also <a href="#icon-prop">icon</a> and <a href="#caption-prop">caption</a>. - -<p>Set this property's value with <a href="#setIconText">setIconText</a>() and get this property's value with <a href="#iconText">iconText</a>(). -<h3 class=fn>bool <a name="inputMethodEnabled-prop"></a>inputMethodEnabled</h3> -<p>This property holds enables or disables the use of input methods for this widget. -<p>Most Widgets (as eg. buttons) that do not handle text input should have -the input method disabled if they have focus. This is the default. -<p> If a widget handles text input it should set this property to TRUE. - -<p>Set this property's value with <a href="#setInputMethodEnabled">setInputMethodEnabled</a>() and get this property's value with <a href="#isInputMethodEnabled">isInputMethodEnabled</a>(). -<h3 class=fn>bool <a name="isActiveWindow-prop"></a>isActiveWindow</h3> -<p>This property holds whether this widget is the active window. -<p>The active window is the window that contains the widget -that has <a href="focus.html#keyboard-focus">keyboard focus</a>. -<p> When popup windows are visible, this property is TRUE for both the -active window <em>and</em> for the popup. -<p> <p>See also <a href="#setActiveWindow">setActiveWindow</a>() and <a href="qapplication.html#activeWindow">TQApplication::activeWindow</a>(). - -<p>Get this property's value with <a href="#isActiveWindow">isActiveWindow</a>(). -<h3 class=fn>bool <a name="isDesktop-prop"></a>isDesktop</h3> -<p>This property holds whether the widget is a desktop widget, i.e. represents the desktop. -<p>A desktop widget is also a top-level widget. -<p> <p>See also <a href="#isTopLevel-prop">isTopLevel</a> and <a href="qapplication.html#desktop">TQApplication::desktop</a>(). - -<p>Get this property's value with <a href="#isDesktop">isDesktop</a>(). -<h3 class=fn>bool <a name="isDialog-prop"></a>isDialog</h3> -<p>This property holds whether the widget is a dialog widget. -<p>A dialog widget is a secondary top-level widget, i.e. a top-level -widget with a parent. -<p> <p>See also <a href="#isTopLevel-prop">isTopLevel</a> and <a href="qdialog.html">TQDialog</a>. - -<p>Get this property's value with <a href="#isDialog">isDialog</a>(). -<h3 class=fn>bool <a name="isModal-prop"></a>isModal</h3> -<p>This property holds whether the widget is a modal widget. -<p>This property only makes sense for top-level widgets. A modal -widget prevents widgets in all other top-level widgets from -getting any input. -<p> <p>See also <a href="#isTopLevel-prop">isTopLevel</a>, <a href="#isDialog-prop">isDialog</a>, and <a href="qdialog.html">TQDialog</a>. - -<p>Get this property's value with <a href="#isModal">isModal</a>(). -<h3 class=fn>bool <a name="isPopup-prop"></a>isPopup</h3> -<p>This property holds whether the widget is a popup widget. -<p>A popup widget is created by specifying the <a href="qt.html#WidgetFlags">widget flag</a> <a href="qt.html#WidgetFlags-enum">WType_Popup</a> to the widget constructor. A popup widget is also a -top-level widget. -<p> <p>See also <a href="#isTopLevel-prop">isTopLevel</a>. - -<p>Get this property's value with <a href="#isPopup">isPopup</a>(). -<h3 class=fn>bool <a name="isTopLevel-prop"></a>isTopLevel</h3> -<p>This property holds whether the widget is a top-level widget. -<p>A top-level widget is a widget which usually has a frame and a -<a href="#caption-prop">caption (title)</a>. <a href="#isPopup">Popup</a> and <a href="#isDesktop">desktop</a> widgets are also top-level widgets. -<p> A top-level widget can have a <a href="#parentWidget">parent - widget</a>. It will then be grouped with its parent and deleted -when the parent is deleted, minimized when the parent is minimized -etc. If supported by the window manager, it will also have a -common taskbar entry with its parent. -<p> <a href="qdialog.html">TQDialog</a> and <a href="qmainwindow.html">TQMainWindow</a> widgets are by default top-level, even if -a parent widget is specified in the constructor. This behavior is -specified by the <a href="qt.html#WidgetFlags-enum">WType_TopLevel</a> widget flag. -<p> <p>See also <a href="#topLevelWidget">topLevelWidget</a>(), <a href="#isDialog-prop">isDialog</a>, <a href="#isModal-prop">isModal</a>, <a href="#isPopup-prop">isPopup</a>, <a href="#isDesktop-prop">isDesktop</a>, and <a href="#parentWidget">parentWidget</a>(). - -<p>Get this property's value with <a href="#isTopLevel">isTopLevel</a>(). -<h3 class=fn>bool <a name="maximized-prop"></a>maximized</h3> -<p>This property holds whether this widget is maximized. -<p>This property is only relevant for top-level widgets. -<p> Note that due to limitations in some window-systems, this does not -always report the expected results (e.g. if the user on X11 -maximizes the window via the window manager, TQt has no way of -distinguishing this from any other resize). This is expected to -improve as window manager protocols evolve. -<p> <p>See also <a href="#windowState">windowState</a>(), <a href="#showMaximized">showMaximized</a>(), <a href="#visible-prop">visible</a>, <a href="#show">show</a>(), <a href="#hide">hide</a>(), <a href="#showNormal">showNormal</a>(), and <a href="#minimized-prop">minimized</a>. - -<p>Get this property's value with <a href="#isMaximized">isMaximized</a>(). -<h3 class=fn>int <a name="maximumHeight-prop"></a>maximumHeight</h3> -<p>This property holds the widget's maximum height. -<p>This property corresponds to <a href="#maximumSize">maximumSize</a>().<a href="#height">height</a>(). -<p> <p>See also <a href="#maximumSize-prop">maximumSize</a> and <a href="#maximumWidth-prop">maximumWidth</a>. - -<p>Set this property's value with <a href="#setMaximumHeight">setMaximumHeight</a>() and get this property's value with <a href="#maximumHeight">maximumHeight</a>(). -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="maximumSize-prop"></a>maximumSize</h3> -<p>This property holds the widget's maximum size. -<p>The widget cannot be resized to a larger size than the maximum -widget size. -<p> <p>See also <a href="#maximumWidth-prop">maximumWidth</a>, <a href="#maximumHeight-prop">maximumHeight</a>, <a href="#maximumSize-prop">maximumSize</a>, <a href="#minimumSize-prop">minimumSize</a>, and <a href="#sizeIncrement-prop">sizeIncrement</a>. - -<p>Set this property's value with <a href="#setMaximumSize">setMaximumSize</a>() and get this property's value with <a href="#maximumSize">maximumSize</a>(). -<h3 class=fn>int <a name="maximumWidth-prop"></a>maximumWidth</h3> -<p>This property holds the widget's maximum width. -<p>This property corresponds to <a href="#maximumSize">maximumSize</a>().<a href="#width">width</a>(). -<p> <p>See also <a href="#maximumSize-prop">maximumSize</a> and <a href="#maximumHeight-prop">maximumHeight</a>. - -<p>Set this property's value with <a href="#setMaximumWidth">setMaximumWidth</a>() and get this property's value with <a href="#maximumWidth">maximumWidth</a>(). -<h3 class=fn><a href="qrect.html">TQRect</a> <a name="microFocusHint-prop"></a>microFocusHint</h3> -<p>This property holds the currently set micro focus hint for this widget. -<p>See the documentation of <a href="#setMicroFocusHint">setMicroFocusHint</a>() for more information. - -<p>Get this property's value with <a href="#microFocusHint">microFocusHint</a>(). -<h3 class=fn>bool <a name="minimized-prop"></a>minimized</h3> -<p>This property holds whether this widget is minimized (iconified). -<p>This property is only relevant for top-level widgets. -<p> <p>See also <a href="#showMinimized">showMinimized</a>(), <a href="#visible-prop">visible</a>, <a href="#show">show</a>(), <a href="#hide">hide</a>(), <a href="#showNormal">showNormal</a>(), and <a href="#maximized-prop">maximized</a>. - -<p>Get this property's value with <a href="#isMinimized">isMinimized</a>(). -<h3 class=fn>int <a name="minimumHeight-prop"></a>minimumHeight</h3> -<p>This property holds the widget's minimum height. -<p>This property corresponds to <a href="#minimumSize">minimumSize</a>().<a href="#height">height</a>(). -<p> <p>See also <a href="#minimumSize-prop">minimumSize</a> and <a href="#minimumWidth-prop">minimumWidth</a>. - -<p>Set this property's value with <a href="#setMinimumHeight">setMinimumHeight</a>() and get this property's value with <a href="#minimumHeight">minimumHeight</a>(). -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="minimumSize-prop"></a>minimumSize</h3> -<p>This property holds the widget's minimum size. -<p>The widget cannot be resized to a smaller size than the minimum -widget size. The widget's size is forced to the minimum size if -the current size is smaller. -<p> If you use a layout inside the widget, the minimum size will be -set by the layout and not by <a href="#setMinimumSize">setMinimumSize</a>(), unless you set the -layout's resize mode to TQLayout::FreeResize. -<p> <p>See also <a href="#minimumWidth-prop">minimumWidth</a>, <a href="#minimumHeight-prop">minimumHeight</a>, <a href="#maximumSize-prop">maximumSize</a>, <a href="#sizeIncrement-prop">sizeIncrement</a>, and <a href="qlayout.html#resizeMode-prop">TQLayout::resizeMode</a>. - -<p>Set this property's value with <a href="#setMinimumSize">setMinimumSize</a>() and get this property's value with <a href="#minimumSize">minimumSize</a>(). -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="minimumSizeHint-prop"></a>minimumSizeHint</h3> -<p>This property holds the recommended minimum size for the widget. -<p>If the value of this property is an invalid size, no minimum size -is recommended. -<p> The default implementation of <a href="#minimumSizeHint">minimumSizeHint</a>() returns an invalid -size if there is no layout for this widget, and returns the -layout's minimum size otherwise. Most built-in widgets reimplement -minimumSizeHint(). -<p> <a href="qlayout.html">TQLayout</a> will never resize a widget to a size smaller than -minimumSizeHint. -<p> <p>See also <a href="qsize.html#isValid">TQSize::isValid</a>(), <a href="#size-prop">size</a>, <a href="#minimumSize-prop">minimumSize</a>, and <a href="#sizePolicy-prop">sizePolicy</a>. - -<p>Get this property's value with <a href="#minimumSizeHint">minimumSizeHint</a>(). -<h3 class=fn>int <a name="minimumWidth-prop"></a>minimumWidth</h3> -<p>This property holds the widget's minimum width. -<p>This property corresponds to <a href="#minimumSize">minimumSize</a>().<a href="#width">width</a>(). -<p> <p>See also <a href="#minimumSize-prop">minimumSize</a> and <a href="#minimumHeight-prop">minimumHeight</a>. - -<p>Set this property's value with <a href="#setMinimumWidth">setMinimumWidth</a>() and get this property's value with <a href="#minimumWidth">minimumWidth</a>(). -<h3 class=fn>bool <a name="mouseTracking-prop"></a>mouseTracking</h3> -<p>This property holds whether mouse tracking is enabled for the widget. -<p>If mouse tracking is disabled (the default), the widget only -receives mouse move events when at least one mouse button is -pressed while the mouse is being moved. -<p> If mouse tracking is enabled, the widget receives mouse move -events even if no buttons are pressed. -<p> <p>See also <a href="#mouseMoveEvent">mouseMoveEvent</a>() and <a href="qapplication.html#setGlobalMouseTracking">TQApplication::setGlobalMouseTracking</a>(). - -<p>Set this property's value with <a href="#setMouseTracking">setMouseTracking</a>() and get this property's value with <a href="#hasMouseTracking">hasMouseTracking</a>(). -<h3 class=fn>bool <a name="ownCursor-prop"></a>ownCursor</h3> -<p>This property holds whether the widget uses its own cursor. -<p>If FALSE, the widget uses its parent widget's cursor. -<p> <p>See also <a href="#cursor-prop">cursor</a>. - -<p>Get this property's value with <a href="#ownCursor">ownCursor</a>(). -<h3 class=fn>bool <a name="ownFont-prop"></a>ownFont</h3> -<p>This property holds whether the widget uses its own font. -<p>If FALSE, the widget uses its parent widget's font. -<p> <p>See also <a href="#font-prop">font</a>. - -<p>Get this property's value with <a href="#ownFont">ownFont</a>(). -<h3 class=fn>bool <a name="ownPalette-prop"></a>ownPalette</h3> -<p>This property holds whether the widget uses its own palette. -<p>If FALSE, the widget uses its parent widget's palette. -<p> <p>See also <a href="#palette-prop">palette</a>. - -<p>Get this property's value with <a href="#ownPalette">ownPalette</a>(). -<h3 class=fn><a href="qpalette.html">TQPalette</a> <a name="palette-prop"></a>palette</h3> -<p>This property holds the widget's palette. -<p>As long as no special palette has been set, or after <a href="#unsetPalette">unsetPalette</a>() -has been called, this is either a special palette for the widget -class, the parent's palette or (if this widget is a top level -widget), the default application palette. -<p> Instead of defining an entirely new palette, you can also use the -<a href="#paletteBackgroundColor-prop">paletteBackgroundColor</a>, -<a href="#paletteBackgroundPixmap-prop">paletteBackgroundPixmap</a> and -<a href="#paletteForegroundColor-prop">paletteForegroundColor</a> -convenience properties to change a widget's -background and foreground appearance only. -<p> <p>See also <a href="#ownPalette-prop">ownPalette</a>, <a href="#colorGroup-prop">colorGroup</a>, and <a href="qapplication.html#palette">TQApplication::palette</a>(). - -<p>Set this property's value with <a href="#setPalette">setPalette</a>(), get this property's value with <a href="#palette">palette</a>(), and reset this property's value with <a href="#unsetPalette">unsetPalette</a>(). -<h3 class=fn><a href="qcolor.html">TQColor</a> <a name="paletteBackgroundColor-prop"></a>paletteBackgroundColor</h3> -<p>This property holds the background color of the widget. -<p>The palette background color is usually set implicitly by -<a href="#setBackgroundMode">setBackgroundMode</a>(), although it can also be set explicitly by -<a href="#setPaletteBackgroundColor">setPaletteBackgroundColor</a>(). setPaletteBackgroundColor() is a -convenience function that creates and sets a modified <a href="qpalette.html">TQPalette</a> -with <a href="#setPalette">setPalette</a>(). The palette is modified according to the -widget's background mode. For example, if the background mode is -<a href="qt.html#BackgroundMode-enum">PaletteButton</a> the color used for the palette's <a href="qcolorgroup.html#ColorRole-enum">TQColorGroup::Button</a> color entry is set. -<p> If there is a background pixmap (set using -<a href="#setPaletteBackgroundPixmap">setPaletteBackgroundPixmap</a>()), then the return value of this -function is indeterminate. -<p> <p>See also <a href="#paletteBackgroundPixmap-prop">paletteBackgroundPixmap</a>, <a href="#paletteForegroundColor-prop">paletteForegroundColor</a>, <a href="#palette-prop">palette</a>, and <a href="#colorGroup-prop">colorGroup</a>. - -<p>Set this property's value with <a href="#setPaletteBackgroundColor">setPaletteBackgroundColor</a>(), get this property's value with <a href="#paletteBackgroundColor">paletteBackgroundColor</a>(), and reset this property's value with <a href="#unsetPalette">unsetPalette</a>(). -<h3 class=fn><a href="qpixmap.html">TQPixmap</a> <a name="paletteBackgroundPixmap-prop"></a>paletteBackgroundPixmap</h3> -<p>This property holds the background pixmap of the widget. -<p>The palette background pixmap is usually set implicitly by -<a href="#setBackgroundMode">setBackgroundMode</a>(), although it can also be set explicitly by -<a href="#setPaletteBackgroundPixmap">setPaletteBackgroundPixmap</a>(). setPaletteBackgroundPixmap() is a -convenience function that creates and sets a modified <a href="qpalette.html">TQPalette</a> -with <a href="#setPalette">setPalette</a>(). The palette is modified according to the -widget's background mode. For example, if the background mode is -<a href="qt.html#BackgroundMode-enum">PaletteButton</a> the pixmap used for the palette's -<a href="qcolorgroup.html#ColorRole-enum">TQColorGroup::Button</a> color entry is set. -<p> If there is a plain background color (set using -<a href="#setPaletteBackgroundColor">setPaletteBackgroundColor</a>()), then this function returns 0. -<p> <p>See also <a href="#paletteBackgroundColor-prop">paletteBackgroundColor</a>, <a href="#paletteForegroundColor-prop">paletteForegroundColor</a>, <a href="#palette-prop">palette</a>, and <a href="#colorGroup-prop">colorGroup</a>. - -<p>Set this property's value with <a href="#setPaletteBackgroundPixmap">setPaletteBackgroundPixmap</a>(), get this property's value with <a href="#paletteBackgroundPixmap">paletteBackgroundPixmap</a>(), and reset this property's value with <a href="#unsetPalette">unsetPalette</a>(). -<h3 class=fn><a href="qcolor.html">TQColor</a> <a name="paletteForegroundColor-prop"></a>paletteForegroundColor</h3> -<p>This property holds the foreground color of the widget. -<p>setPaletteForegroundColor() is a convenience function that creates -and sets a modified <a href="qpalette.html">TQPalette</a> with <a href="#setPalette">setPalette</a>(). The palette is -modified according to the widget's <em>background mode</em>. For -example, if the background mode is <a href="qt.html#BackgroundMode-enum">PaletteButton</a> the palette entry -<a href="qcolorgroup.html#ColorRole-enum">TQColorGroup::ButtonText</a> is set to color. -<p> <p>See also <a href="#palette-prop">palette</a>, <a href="qapplication.html#setPalette">TQApplication::setPalette</a>(), <a href="#backgroundMode-prop">backgroundMode</a>, <a href="#foregroundColor">foregroundColor</a>(), <a href="#backgroundMode-prop">backgroundMode</a>, and <a href="#setEraseColor">setEraseColor</a>(). - -<p>Set this property's value with <a href="#setPaletteForegroundColor">setPaletteForegroundColor</a>(), get this property's value with <a href="#paletteForegroundColor">paletteForegroundColor</a>(), and reset this property's value with <a href="#unsetPalette">unsetPalette</a>(). -<h3 class=fn><a href="qpoint.html">TQPoint</a> <a name="pos-prop"></a>pos</h3> -<p>This property holds the position of the widget within its parent widget. -<p>If the widget is a top-level widget, the position is that of the -widget on the desktop, including its frame. -<p> When changing the position, the widget, if visible, receives a -move event (<a href="#moveEvent">moveEvent</a>()) immediately. If the widget is not -currently visible, it is guaranteed to receive an event before it -is shown. -<p> <a href="#move">move</a>() is virtual, and all other overloaded move() implementations -in TQt call it. -<p> <b>Warning:</b> Calling move() or <a href="#setGeometry">setGeometry</a>() inside moveEvent() can -lead to infinite recursion. -<p> See the <a href="geometry.html">Window Geometry documentation</a> -for an overview of top-level widget geometry. -<p> <p>See also <a href="#frameGeometry-prop">frameGeometry</a>, <a href="#size-prop">size</a>, <a href="#x-prop">x</a>, and <a href="#y-prop">y</a>. - -<p>Set this property's value with <a href="#move">move</a>() and get this property's value with <a href="#pos">pos</a>(). -<h3 class=fn><a href="qrect.html">TQRect</a> <a name="rect-prop"></a>rect</h3> -<p>This property holds the internal geometry of the widget excluding any window frame. -<p>The rect property equals <a href="qrect.html">TQRect</a>(0, 0, <a href="#width">width</a>(), <a href="#height">height</a>()). -<p> See the <a href="geometry.html">Window Geometry documentation</a> -for an overview of top-level widget geometry. -<p> <p>See also <a href="#size-prop">size</a>. - -<p>Get this property's value with <a href="#rect">rect</a>(). -<h3 class=fn>bool <a name="shown-prop"></a>shown</h3> -<p>This property holds whether the widget is shown. -<p>If TRUE, the widget is visible or would become visible if all its -ancestors became visible. -<p> <p>See also <a href="#hide">hide</a>(), <a href="#show">show</a>(), <a href="#visible-prop">visible</a>, <a href="#isVisibleTo">isVisibleTo</a>(), and <a href="#hidden-prop">hidden</a>. - -<p>Set this property's value with <a href="#setShown">setShown</a>() and get this property's value with <a href="#isShown">isShown</a>(). -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="size-prop"></a>size</h3> -<p>This property holds the size of the widget excluding any window frame. -<p>When resizing, the widget, if visible, receives a resize event -(<a href="#resizeEvent">resizeEvent</a>()) immediately. If the widget is not currently -visible, it is guaranteed to receive an event before it is shown. -<p> The size is adjusted if it lies outside the range defined by -<a href="#minimumSize">minimumSize</a>() and <a href="#maximumSize">maximumSize</a>(). Furthermore, the size is always -at least <a href="qsize.html">TQSize</a>(1, 1). For toplevel widgets, the minimum size -might be larger, depending on the window manager. -<p> If you want a top-level window to have a fixed size, call -setResizeMode( TQLayout::FreeResize ) on its layout. -<p> <a href="#resize">resize</a>() is virtual, and all other overloaded resize() -implementations in TQt call it. -<p> <b>Warning:</b> Calling resize() or <a href="#setGeometry">setGeometry</a>() inside resizeEvent() can -lead to infinite recursion. -<p> <p>See also <a href="#pos-prop">pos</a>, <a href="#geometry-prop">geometry</a>, <a href="#minimumSize-prop">minimumSize</a>, <a href="#maximumSize-prop">maximumSize</a>, and <a href="#resizeEvent">resizeEvent</a>(). - -<p>Set this property's value with <a href="#resize">resize</a>() and get this property's value with <a href="#size">size</a>(). -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="sizeHint-prop"></a>sizeHint</h3> -<p>This property holds the recommended size for the widget. -<p>If the value of this property is an invalid size, no size is -recommended. -<p> The default implementation of <a href="#sizeHint">sizeHint</a>() returns an invalid size -if there is no layout for this widget, and returns the layout's -preferred size otherwise. -<p> <p>See also <a href="qsize.html#isValid">TQSize::isValid</a>(), <a href="#minimumSizeHint-prop">minimumSizeHint</a>, <a href="#sizePolicy-prop">sizePolicy</a>, <a href="#minimumSize-prop">minimumSize</a>, and <a href="#updateGeometry">updateGeometry</a>(). - -<p>Get this property's value with <a href="#sizeHint">sizeHint</a>(). -<h3 class=fn><a href="qsize.html">TQSize</a> <a name="sizeIncrement-prop"></a>sizeIncrement</h3> -<p>This property holds the size increment of the widget. -<p>When the user resizes the window, the size will move in steps of -<a href="#sizeIncrement">sizeIncrement</a>().<a href="#width">width</a>() pixels horizontally and -sizeIncrement.<a href="#height">height</a>() pixels vertically, with <a href="#baseSize">baseSize</a>() as the -basis. Preferred widget sizes are for non-negative integers <em>i</em> -and <em>j</em>: -<pre> - <a href="#width-prop">width</a> = <a href="#baseSize">baseSize</a>().width() + i * sizeIncrement().width(); - <a href="#height-prop">height</a> = <a href="#baseSize">baseSize</a>().height() + j * sizeIncrement().height(); - </pre> - -<p> Note that while you can set the size increment for all widgets, it -only affects top-level widgets. -<p> <b>Warning:</b> The size increment has no effect under Windows, and may -be disregarded by the window manager on X. -<p> <p>See also <a href="#size-prop">size</a>, <a href="#minimumSize-prop">minimumSize</a>, and <a href="#maximumSize-prop">maximumSize</a>. - -<p>Set this property's value with <a href="#setSizeIncrement">setSizeIncrement</a>() and get this property's value with <a href="#sizeIncrement">sizeIncrement</a>(). -<h3 class=fn><a href="qsizepolicy.html">TQSizePolicy</a> <a name="sizePolicy-prop"></a>sizePolicy</h3> -<p>This property holds the default layout behavior of the widget. -<p>If there is a <a href="qlayout.html">TQLayout</a> that manages this widget's children, the -size policy specified by that layout is used. If there is no such -TQLayout, the result of this function is used. -<p> The default policy is Preferred/Preferred, which means that the -widget can be freely resized, but prefers to be the size -<a href="#sizeHint">sizeHint</a>() returns. Button-like widgets set the size policy to -specify that they may stretch horizontally, but are fixed -vertically. The same applies to lineedit controls (such as -<a href="qlineedit.html">TQLineEdit</a>, <a href="qspinbox.html">TQSpinBox</a> or an editable <a href="qcombobox.html">TQComboBox</a>) and other -horizontally orientated widgets (such as <a href="qprogressbar.html">TQProgressBar</a>). -<a href="qtoolbutton.html">TQToolButton</a>'s are normally square, so they allow growth in both -directions. Widgets that support different directions (such as -<a href="qslider.html">TQSlider</a>, <a href="qscrollbar.html">TQScrollBar</a> or <a href="qheader.html">TQHeader</a>) specify stretching in the -respective direction only. Widgets that can provide scrollbars -(usually subclasses of <a href="qscrollview.html">TQScrollView</a>) tend to specify that they can -use additional space, and that they can make do with less than -sizeHint(). -<p> <p>See also <a href="#sizeHint-prop">sizeHint</a>, <a href="qlayout.html">TQLayout</a>, <a href="qsizepolicy.html">TQSizePolicy</a>, and <a href="#updateGeometry">updateGeometry</a>(). - -<p>Set this property's value with <a href="#setSizePolicy">setSizePolicy</a>() and get this property's value with <a href="#sizePolicy">sizePolicy</a>(). -<h3 class=fn>bool <a name="underMouse-prop"></a>underMouse</h3> -<p>This property holds whether the widget is under the mouse cursor. -<p>This value is not updated properly during drag and drop -operations. -<p> <p>See also <a href="qevent.html#Type-enum">TQEvent::Enter</a> and <a href="qevent.html#Type-enum">TQEvent::Leave</a>. - -<p>Get this property's value with <a href="#hasMouse">hasMouse</a>(). -<h3 class=fn>bool <a name="updatesEnabled-prop"></a>updatesEnabled</h3> -<p>This property holds whether updates are enabled. -<p>Calling <a href="#update">update</a>() and <a href="#repaint">repaint</a>() has no effect if updates are -disabled. Paint events from the window system are processed -normally even if updates are disabled. -<p> <a href="#setUpdatesEnabled">setUpdatesEnabled</a>() is normally used to disable updates for a -short period of time, for instance to avoid screen flicker during -large changes. -<p> Example: -<pre> - <a href="#setUpdatesEnabled">setUpdatesEnabled</a>( FALSE ); - bigVisualChanges(); - <a href="#setUpdatesEnabled">setUpdatesEnabled</a>( TRUE ); - <a href="#repaint">repaint</a>(); - </pre> - -<p> <p>See also <a href="#update">update</a>(), <a href="#repaint">repaint</a>(), and <a href="#paintEvent">paintEvent</a>(). - -<p>Set this property's value with <a href="#setUpdatesEnabled">setUpdatesEnabled</a>() and get this property's value with <a href="#isUpdatesEnabled">isUpdatesEnabled</a>(). -<h3 class=fn>bool <a name="visible-prop"></a>visible</h3> -<p>This property holds whether the widget is visible. -<p>Calling <a href="#show">show</a>() sets the widget to visible status if all its parent -widgets up to the top-level widget are visible. If an ancestor is -not visible, the widget won't become visible until all its -ancestors are shown. -<p> Calling <a href="#hide">hide</a>() hides a widget explicitly. An explicitly hidden -widget will never become visible, even if all its ancestors become -visible, unless you show it. -<p> A widget receives show and hide events when its visibility status -changes. Between a hide and a show event, there is no need to -waste CPU cycles preparing or displaying information to the user. -A video application, for example, might simply stop generating new -frames. -<p> A widget that happens to be obscured by other windows on the -screen is considered to be visible. The same applies to iconified -top-level widgets and windows that exist on another virtual -desktop (on platforms that support this concept). A widget -receives spontaneous show and hide events when its mapping status -is changed by the window system, e.g. a spontaneous hide event -when the user minimizes the window, and a spontaneous show event -when the window is restored again. -<p> <p>See also <a href="#show">show</a>(), <a href="#hide">hide</a>(), <a href="#hidden-prop">hidden</a>, <a href="#isVisibleTo">isVisibleTo</a>(), <a href="#minimized-prop">minimized</a>, <a href="#showEvent">showEvent</a>(), and <a href="#hideEvent">hideEvent</a>(). - -<p>Get this property's value with <a href="#isVisible">isVisible</a>(). -<h3 class=fn><a href="qrect.html">TQRect</a> <a name="visibleRect-prop"></a>visibleRect</h3> -<p>This property holds the visible rectangle. -<p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -<p> No longer necessary, you can simply call <a href="#repaint">repaint</a>(). If you do not -need the rectangle for repaint(), use <a href="#clipRegion">clipRegion</a>() instead. - -<p>Get this property's value with <a href="#visibleRect">visibleRect</a>(). -<h3 class=fn>int <a name="width-prop"></a>width</h3> -<p>This property holds the width of the widget excluding any window frame. -<p>See the <a href="geometry.html">Window Geometry documentation</a> -for an overview of top-level widget geometry. -<p> <p>See also <a href="#geometry-prop">geometry</a>, <a href="#height-prop">height</a>, and <a href="#size-prop">size</a>. - -<p>Get this property's value with <a href="#width">width</a>(). -<h3 class=fn>double <a name="windowOpacity-prop"></a>windowOpacity</h3> -<p>This property holds the level of opacity for the window. -<p>The valid range of opacity is from 1.0 (completely opaque) to -0.0 (completely transparent). -<p> By default the value of this property is 1.0. -<p> This feature is only present on Mac OS X and Windows 2000 and up. -<p> <b>Warning:</b> Changing this property from opaque to transparent might issue a -paint event that needs to be processed before the window is displayed -correctly. This affects mainly the use of <a href="qpixmap.html#grabWindow">TQPixmap::grabWindow</a>(). Also note -that semi-transparent windows update and resize significantely slower than -opaque windows. - -<p>Set this property's value with <a href="#setWindowOpacity">setWindowOpacity</a>() and get this property's value with <a href="#windowOpacity">windowOpacity</a>(). -<h3 class=fn>int <a name="x-prop"></a>x</h3> <p>This property holds the x coordinate of the widget relative to its parent including any window frame. -<p>See the <a href="geometry.html">Window Geometry documentation</a> -for an overview of top-level widget geometry. -<p> <p>See also <a href="#frameGeometry-prop">frameGeometry</a>, <a href="#y-prop">y</a>, and <a href="#pos-prop">pos</a>. - -<p>Get this property's value with <a href="#x">x</a>(). -<h3 class=fn>int <a name="y-prop"></a>y</h3> -<p>This property holds the y coordinate of the widget relative to its parent and including any window frame. -<p>See the <a href="geometry.html">Window Geometry documentation</a> -for an overview of top-level widget geometry. -<p> <p>See also <a href="#frameGeometry-prop">frameGeometry</a>, <a href="#x-prop">x</a>, and <a href="#pos-prop">pos</a>. - -<p>Get this property's value with <a href="#y">y</a>(). -<!-- eof --> -<hr><p> -This file is part of the <a href="index.html">TQt toolkit</a>. -Copyright © 1995-2007 -<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<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>TQt 3.3.8</div> -</table></div></address></body> -</html> |