diff options
Diffstat (limited to 'doc/html/qwidget.html')
| -rw-r--r-- | doc/html/qwidget.html | 3256 |
1 files changed, 3256 insertions, 0 deletions
diff --git a/doc/html/qwidget.html b/doc/html/qwidget.html new file mode 100644 index 0000000..1a63ad2 --- /dev/null +++ b/doc/html/qwidget.html @@ -0,0 +1,3256 @@ +<!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>QWidget 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>QWidget Class Reference</h1> + +<p>The QWidget 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">QObject</a> and <a href="qpaintdevice.html">QPaintDevice</a>. +<p>Inherited by <a href="qaxwidget.html">QAxWidget</a>, <a href="qbutton.html">QButton</a>, <a href="qframe.html">QFrame</a>, <a href="qdialog.html">QDialog</a>, <a href="qcombobox.html">QComboBox</a>, <a href="qdatabrowser.html">QDataBrowser</a>, <a href="qdataview.html">QDataView</a>, <a href="qdatetimeeditbase.html">QDateTimeEditBase</a>, <a href="qdatetimeedit.html">QDateTimeEdit</a>, <a href="qdesktopwidget.html">QDesktopWidget</a>, <a href="qdial.html">QDial</a>, <a href="qdockarea.html">QDockArea</a>, <a href="qglwidget.html">QGLWidget</a>, <a href="qheader.html">QHeader</a>, <a href="qmainwindow.html">QMainWindow</a>, <a href="qmotifwidget.html">QMotifWidget</a>, <a href="qnpwidget.html">QNPWidget</a>, <a href="qscrollbar.html">QScrollBar</a>, <a href="qsizegrip.html">QSizeGrip</a>, <a href="qslider.html">QSlider</a>, <a href="qspinbox.html">QSpinBox</a>, <a href="qsplashscreen.html">QSplashScreen</a>, <a href="qstatusbar.html">QStatusBar</a>, <a href="qtabbar.html">QTabBar</a>, <a href="qtabwidget.html">QTabWidget</a>, <a href="qworkspace.html">QWorkspace</a>, and <a href="qxtwidget.html">QXtWidget</a>. +<p><a href="qwidget-members.html">List of all member functions.</a> +<h2>Public Members</h2> +<ul> +<li class=fn>explicit <a href="#QWidget"><b>QWidget</b></a> ( QWidget * parent = 0, const char * name = 0, WFlags f = 0 )</li> +<li class=fn><a href="#~QWidget"><b>~QWidget</b></a> ()</li> +<li class=fn>WId <a href="#winId"><b>winId</b></a> () const</li> +<li class=fn>QStyle & <a href="#style"><b>style</b></a> () const</li> +<li class=fn>void <a href="#setStyle"><b>setStyle</b></a> ( QStyle * style )</li> +<li class=fn>QStyle * <a href="#setStyle-2"><b>setStyle</b></a> ( const QString & 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> ( QWidget * ancestor ) const</li> +<li class=fn>bool isEnabledToTLW () const <em>(obsolete)</em></li> +<li class=fn>QRect <a href="#frameGeometry"><b>frameGeometry</b></a> () const</li> +<li class=fn>const QRect & <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>QPoint <a href="#pos"><b>pos</b></a> () const</li> +<li class=fn>QSize <a href="#frameSize"><b>frameSize</b></a> () const</li> +<li class=fn>QSize <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>QRect <a href="#rect"><b>rect</b></a> () const</li> +<li class=fn>QRect <a href="#childrenRect"><b>childrenRect</b></a> () const</li> +<li class=fn>QRegion <a href="#childrenRegion"><b>childrenRegion</b></a> () const</li> +<li class=fn>QSize <a href="#minimumSize"><b>minimumSize</b></a> () const</li> +<li class=fn>QSize <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 QSize & )</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 QSize & )</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>QSize <a href="#sizeIncrement"><b>sizeIncrement</b></a> () const</li> +<li class=fn>void <a href="#setSizeIncrement"><b>setSizeIncrement</b></a> ( const QSize & )</li> +<li class=fn>virtual void <a href="#setSizeIncrement-2"><b>setSizeIncrement</b></a> ( int w, int h )</li> +<li class=fn>QSize <a href="#baseSize"><b>baseSize</b></a> () const</li> +<li class=fn>void <a href="#setBaseSize"><b>setBaseSize</b></a> ( const QSize & )</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 QSize & 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>QPoint <a href="#mapToGlobal"><b>mapToGlobal</b></a> ( const QPoint & pos ) const</li> +<li class=fn>QPoint <a href="#mapFromGlobal"><b>mapFromGlobal</b></a> ( const QPoint & pos ) const</li> +<li class=fn>QPoint <a href="#mapToParent"><b>mapToParent</b></a> ( const QPoint & pos ) const</li> +<li class=fn>QPoint <a href="#mapFromParent"><b>mapFromParent</b></a> ( const QPoint & pos ) const</li> +<li class=fn>QPoint <a href="#mapTo"><b>mapTo</b></a> ( QWidget * parent, const QPoint & pos ) const</li> +<li class=fn>QPoint <a href="#mapFrom"><b>mapFrom</b></a> ( QWidget * parent, const QPoint & pos ) const</li> +<li class=fn>QWidget * <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 QColor & <a href="#foregroundColor"><b>foregroundColor</b></a> () const</li> +<li class=fn>const QColor & <a href="#eraseColor"><b>eraseColor</b></a> () const</li> +<li class=fn>virtual void <a href="#setEraseColor"><b>setEraseColor</b></a> ( const QColor & color )</li> +<li class=fn>const QPixmap * <a href="#erasePixmap"><b>erasePixmap</b></a> () const</li> +<li class=fn>virtual void <a href="#setErasePixmap"><b>setErasePixmap</b></a> ( const QPixmap & pixmap )</li> +<li class=fn>const QColorGroup & <a href="#colorGroup"><b>colorGroup</b></a> () const</li> +<li class=fn>const QPalette & <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 QPalette & )</li> +<li class=fn>void <a href="#unsetPalette"><b>unsetPalette</b></a> ()</li> +<li class=fn>const QColor & <a href="#paletteForegroundColor"><b>paletteForegroundColor</b></a> () const</li> +<li class=fn>void <a href="#setPaletteForegroundColor"><b>setPaletteForegroundColor</b></a> ( const QColor & )</li> +<li class=fn>const QColor & <a href="#paletteBackgroundColor"><b>paletteBackgroundColor</b></a> () const</li> +<li class=fn>virtual void <a href="#setPaletteBackgroundColor"><b>setPaletteBackgroundColor</b></a> ( const QColor & )</li> +<li class=fn>const QPixmap * <a href="#paletteBackgroundPixmap"><b>paletteBackgroundPixmap</b></a> () const</li> +<li class=fn>virtual void <a href="#setPaletteBackgroundPixmap"><b>setPaletteBackgroundPixmap</b></a> ( const QPixmap & )</li> +<li class=fn>const QBrush & <a href="#backgroundBrush"><b>backgroundBrush</b></a> () const</li> +<li class=fn>QFont <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 QFont & )</li> +<li class=fn>void <a href="#unsetFont"><b>unsetFont</b></a> ()</li> +<li class=fn>QFontMetrics <a href="#fontMetrics"><b>fontMetrics</b></a> () const</li> +<li class=fn>QFontInfo <a href="#fontInfo"><b>fontInfo</b></a> () const</li> +<li class=fn>const QCursor & <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 QCursor & )</li> +<li class=fn>virtual void <a href="#unsetCursor"><b>unsetCursor</b></a> ()</li> +<li class=fn>QString <a href="#caption"><b>caption</b></a> () const</li> +<li class=fn>const QPixmap * <a href="#icon"><b>icon</b></a> () const</li> +<li class=fn>QString <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 QBitmap & bitmap )</li> +<li class=fn>virtual void <a href="#setMask-2"><b>setMask</b></a> ( const QRegion & region )</li> +<li class=fn>void <a href="#clearMask"><b>clearMask</b></a> ()</li> +<li class=fn>const QColor & backgroundColor () const <em>(obsolete)</em></li> +<li class=fn>virtual void setBackgroundColor ( const QColor & c ) <em>(obsolete)</em></li> +<li class=fn>const QPixmap * backgroundPixmap () const <em>(obsolete)</em></li> +<li class=fn>virtual void setBackgroundPixmap ( const QPixmap & 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> ( QWidget * w )</li> +<li class=fn>QWidget * <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 QCursor & 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> ( QWidget * ancestor ) const</li> +<li class=fn>bool isVisibleToTLW () const <em>(obsolete)</em></li> +<li class=fn>QRect 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 QSize <a href="#sizeHint"><b>sizeHint</b></a> () const</li> +<li class=fn>virtual QSize <a href="#minimumSizeHint"><b>minimumSizeHint</b></a> () const</li> +<li class=fn>virtual QSizePolicy <a href="#sizePolicy"><b>sizePolicy</b></a> () const</li> +<li class=fn>virtual void <a href="#setSizePolicy"><b>setSizePolicy</b></a> ( QSizePolicy )</li> +<li class=fn>void <a href="#setSizePolicy-2"><b>setSizePolicy</b></a> ( QSizePolicy::SizeType hor, QSizePolicy::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>QRegion <a href="#clipRegion"><b>clipRegion</b></a> () const</li> +<li class=fn>QLayout * <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> ( QWidget * parent, WFlags f, const QPoint & p, bool showIt = FALSE )</li> +<li class=fn>void <a href="#reparent-2"><b>reparent</b></a> ( QWidget * parent, const QPoint & p, bool showIt = FALSE )</li> +<li class=fn>void recreate ( QWidget * parent, WFlags f, const QPoint & 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 QRect & r )</li> +<li class=fn>void <a href="#erase-4"><b>erase</b></a> ( const QRegion & 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 QRect & r )</li> +<li class=fn>void <a href="#drawText"><b>drawText</b></a> ( int x, int y, const QString & str )</li> +<li class=fn>void <a href="#drawText-2"><b>drawText</b></a> ( const QPoint & pos, const QString & str )</li> +<li class=fn>QWidget * <a href="#focusWidget"><b>focusWidget</b></a> () const</li> +<li class=fn>QRect <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>QWidget * <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>QWidget * <a href="#childAt"><b>childAt</b></a> ( int x, int y, bool includeThis = FALSE ) const</li> +<li class=fn>QWidget * <a href="#childAt-2"><b>childAt</b></a> ( const QPoint & 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 QPalette & p, bool ) <em>(obsolete)</em></li> +<li class=fn>void setFont ( const QFont & 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 QString & )</li> +<li class=fn>virtual void <a href="#setIcon"><b>setIcon</b></a> ( const QPixmap & )</li> +<li class=fn>virtual void <a href="#setIconText"><b>setIconText</b></a> ( const QString & )</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 QRect & 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 QRect & r, bool erase = TRUE )</li> +<li class=fn>void <a href="#repaint-5"><b>repaint</b></a> ( const QRegion & 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> ( QWidget * 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 QPoint & )</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 QSize & )</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 QRect & )</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> ( QWidget * first, QWidget * second )</li> +<li class=fn>QWidget * <a href="#mouseGrabber"><b>mouseGrabber</b></a> ()</li> +<li class=fn>QWidget * <a href="#keyboardGrabber"><b>keyboardGrabber</b></a> ()</li> +<li class=fn>QWidget * <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>QBrush <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>QSize <a href="#baseSize-prop"><b>baseSize</b></a> - the base size of the widget</li> +<li class=fn>QString <a href="#caption-prop"><b>caption</b></a> - the window caption (title)</li> +<li class=fn>QRect <a href="#childrenRect-prop"><b>childrenRect</b></a> - the bounding rectangle of the widget's children <em>(read only)</em></li> +<li class=fn>QRegion <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>QColorGroup <a href="#colorGroup-prop"><b>colorGroup</b></a> - the current color group of the widget palette <em>(read only)</em></li> +<li class=fn>QCursor <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>QFont <a href="#font-prop"><b>font</b></a> - the font currently set for the widget</li> +<li class=fn>QRect <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>QSize <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>QRect <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>QPixmap <a href="#icon-prop"><b>icon</b></a> - the widget's icon</li> +<li class=fn>QString <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>QSize <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>QRect <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>QSize <a href="#minimumSize-prop"><b>minimumSize</b></a> - the widget's minimum size</li> +<li class=fn>QSize <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>QPalette <a href="#palette-prop"><b>palette</b></a> - the widget's palette</li> +<li class=fn>QColor <a href="#paletteBackgroundColor-prop"><b>paletteBackgroundColor</b></a> - the background color of the widget</li> +<li class=fn>QPixmap <a href="#paletteBackgroundPixmap-prop"><b>paletteBackgroundPixmap</b></a> - the background pixmap of the widget</li> +<li class=fn>QColor <a href="#paletteForegroundColor-prop"><b>paletteForegroundColor</b></a> - the foreground color of the widget</li> +<li class=fn>QPoint <a href="#pos-prop"><b>pos</b></a> - the position of the widget within its parent widget</li> +<li class=fn>QRect <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>QSize <a href="#size-prop"><b>size</b></a> - the size of the widget excluding any window frame</li> +<li class=fn>QSize <a href="#sizeHint-prop"><b>sizeHint</b></a> - the recommended size for the widget <em>(read only)</em></li> +<li class=fn>QSize <a href="#sizeIncrement-prop"><b>sizeIncrement</b></a> - the size increment of the widget</li> +<li class=fn>QSizePolicy <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>QRect 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> ( QEvent * e )</li> +<li class=fn>virtual void <a href="#mousePressEvent"><b>mousePressEvent</b></a> ( QMouseEvent * e )</li> +<li class=fn>virtual void <a href="#mouseReleaseEvent"><b>mouseReleaseEvent</b></a> ( QMouseEvent * e )</li> +<li class=fn>virtual void <a href="#mouseDoubleClickEvent"><b>mouseDoubleClickEvent</b></a> ( QMouseEvent * e )</li> +<li class=fn>virtual void <a href="#mouseMoveEvent"><b>mouseMoveEvent</b></a> ( QMouseEvent * e )</li> +<li class=fn>virtual void <a href="#wheelEvent"><b>wheelEvent</b></a> ( QWheelEvent * e )</li> +<li class=fn>virtual void <a href="#keyPressEvent"><b>keyPressEvent</b></a> ( QKeyEvent * e )</li> +<li class=fn>virtual void <a href="#keyReleaseEvent"><b>keyReleaseEvent</b></a> ( QKeyEvent * e )</li> +<li class=fn>virtual void <a href="#focusInEvent"><b>focusInEvent</b></a> ( QFocusEvent * )</li> +<li class=fn>virtual void <a href="#focusOutEvent"><b>focusOutEvent</b></a> ( QFocusEvent * )</li> +<li class=fn>virtual void <a href="#enterEvent"><b>enterEvent</b></a> ( QEvent * )</li> +<li class=fn>virtual void <a href="#leaveEvent"><b>leaveEvent</b></a> ( QEvent * )</li> +<li class=fn>virtual void <a href="#paintEvent"><b>paintEvent</b></a> ( QPaintEvent * )</li> +<li class=fn>virtual void <a href="#moveEvent"><b>moveEvent</b></a> ( QMoveEvent * )</li> +<li class=fn>virtual void <a href="#resizeEvent"><b>resizeEvent</b></a> ( QResizeEvent * )</li> +<li class=fn>virtual void <a href="#closeEvent"><b>closeEvent</b></a> ( QCloseEvent * e )</li> +<li class=fn>virtual void <a href="#contextMenuEvent"><b>contextMenuEvent</b></a> ( QContextMenuEvent * e )</li> +<li class=fn>virtual void <a href="#imStartEvent"><b>imStartEvent</b></a> ( QIMEvent * e )</li> +<li class=fn>virtual void <a href="#imComposeEvent"><b>imComposeEvent</b></a> ( QIMEvent * e )</li> +<li class=fn>virtual void <a href="#imEndEvent"><b>imEndEvent</b></a> ( QIMEvent * e )</li> +<li class=fn>virtual void <a href="#tabletEvent"><b>tabletEvent</b></a> ( QTabletEvent * e )</li> +<li class=fn>virtual void <a href="#dragEnterEvent"><b>dragEnterEvent</b></a> ( QDragEnterEvent * )</li> +<li class=fn>virtual void <a href="#dragMoveEvent"><b>dragMoveEvent</b></a> ( QDragMoveEvent * )</li> +<li class=fn>virtual void <a href="#dragLeaveEvent"><b>dragLeaveEvent</b></a> ( QDragLeaveEvent * )</li> +<li class=fn>virtual void <a href="#dropEvent"><b>dropEvent</b></a> ( QDropEvent * )</li> +<li class=fn>virtual void <a href="#showEvent"><b>showEvent</b></a> ( QShowEvent * )</li> +<li class=fn>virtual void <a href="#hideEvent"><b>hideEvent</b></a> ( QHideEvent * )</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> ( QWSEvent * )</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> ( QStyle & 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 QPalette & oldPalette )</li> +<li class=fn>virtual void <a href="#fontChange"><b>fontChange</b></a> ( const QFont & 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>QFocusData * <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, QFont * f = 0 )</li> +</ul> +<hr><a name="details"></a><h2>Detailed Description</h2> + + +The QWidget 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 Qt, <a href="qmainwindow.html">QMainWindow</a> and the various subclasses of +<a href="qdialog.html">QDialog</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 Qt 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. QDialog.) +<p> If you want to use a QWidget to hold child widgets you will +probably want to add a layout to the parent QWidget. (See <a href="layout.html">Layouts</a>.) +<p> QWidget has many member functions, but some of them have little +direct functionality: for example, QWidget has a font property, +but never uses this itself. There are many subclasses which +provide real functionality, such as <a href="qpushbutton.html">QPushButton</a>, <a href="qlistbox.html">QListBox</a> and +<a href="qtabdialog.html">QTabDialog</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>QWidget *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>Qt Designer</em> (you can name a widget in <em>Qt 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">QWidget::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">QWidget::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">QEvent</a>, <a href="qpainter.html">QPainter</a>, <a href="qgridlayout.html">QGridLayout</a>, <a href="qboxlayout.html">QBoxLayout</a>, and <a href="abstractwidgets.html">Abstract Widget Classes</a>. + +<hr><h2>Member Type Documentation</h2> +<h3 class=fn><a name="BackgroundOrigin-enum"></a>QWidget::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>QWidget::WidgetOrigin</tt> - widget's coordinate system. +<li><tt>QWidget::ParentOrigin</tt> - parent's coordinate system. +<li><tt>QWidget::WindowOrigin</tt> - top-level window's coordinate system. +<li><tt>QWidget::AncestorOrigin</tt> - same origin as the parent uses. +</ul> +<h3 class=fn><a name="FocusPolicy-enum"></a>QWidget::FocusPolicy</h3> + +<p> This enum type defines the various policies a widget can have with +respect to acquiring <a href="focus.html#keyboard-focus">keyboard focus</a>. +<ul> +<li><tt>QWidget::TabFocus</tt> - the widget accepts focus by tabbing. +<li><tt>QWidget::ClickFocus</tt> - the widget accepts focus by clicking. +<li><tt>QWidget::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>QWidget::WheelFocus</tt> - like StrongFocus plus the widget accepts +focus by using the mouse wheel. +<li><tt>QWidget::NoFocus</tt> - the widget does not accept focus. +</ul><p> +<hr><h2>Member Function Documentation</h2> +<h3 class=fn>explicit <a name="QWidget"></a>QWidget::QWidget ( <a href="qwidget.html">QWidget</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">QObject</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">Qt::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 Qt may not be able to deliver all +combinations of style flags on all systems. This is because on +X11, Qt can only ask the window manager, and the window manager +can override the application's settings. On Windows, Qt can set +whatever flags you want. +<p> Example: +<pre> + <a href="qlabel.html">QLabel</a> *splashScreen = new <a href="qlabel.html">QLabel</a>( 0, "mySplashScreen", + WStyle_Customize | WStyle_Splash ); + </pre> + + +<h3 class=fn><a name="~QWidget"></a>QWidget::~QWidget () +</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>QWidget::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>QWidget::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">QMessageBox</a>. +<h3 class=fn>bool <a name="autoMask"></a>QWidget::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">QBrush</a> & <a name="backgroundBrush"></a>QWidget::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">QColor</a> & <a name="backgroundColor"></a>QWidget::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>QWidget::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>QWidget::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">QPixmap</a> * <a name="backgroundPixmap"></a>QWidget::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">QSize</a> <a name="baseSize"></a>QWidget::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">QString</a> <a name="caption"></a>QWidget::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">QWidget</a> * <a name="childAt"></a>QWidget::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">QWidget</a> * <a name="childAt-2"></a>QWidget::childAt ( const <a href="qpoint.html">QPoint</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">QRect</a> <a name="childrenRect"></a>QWidget::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">QRegion</a> <a name="childrenRegion"></a>QWidget::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>QWidget::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">QApplication::focusWidget</a>(). + +<h3 class=fn>void <a name="clearMask"></a>QWidget::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>QWidget::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">Qt::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">QRegion</a> <a name="clipRegion"></a>QWidget::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>QWidget::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">QCloseEvent</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">QWidget::closeEvent</a>() accepts the close event. +<p> The <a href="qapplication.html#lastWindowClosed">QApplication::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>QWidget::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">QCloseEvent</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">QApplication::lastWindowClosed</a>() signal is emitted when the +last visible top level widget is closed. +<p> Note that closing the <a href="qapplication.html#mainWidget">QApplication::mainWidget</a>() terminates the +application. +<p> <p>See also <a href="#closeEvent">closeEvent</a>(), <a href="qcloseevent.html">QCloseEvent</a>, <a href="#hide">hide</a>(), <a href="qapplication.html#quit">QApplication::quit</a>(), <a href="qapplication.html#setMainWidget">QApplication::setMainWidget</a>(), and <a href="qapplication.html#lastWindowClosed">QApplication::lastWindowClosed</a>(). + +<h3 class=fn>void <a name="closeEvent"></a>QWidget::closeEvent ( <a href="qcloseevent.html">QCloseEvent</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">QCloseEvent</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">QCloseEvent</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">QColorGroup</a> & <a name="colorGroup"></a>QWidget::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>QWidget::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>QWidget::contextMenuEvent ( <a href="qcontextmenuevent.html">QContextMenuEvent</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">QContextMenuEvent</a> documentation for +more details. +<p> <p>See also <a href="#event">event</a>() and <a href="qcontextmenuevent.html">QContextMenuEvent</a>. + +<p>Example: <a href="menu-example.html#x1881">menu/menu.cpp</a>. +<h3 class=fn>void <a name="create"></a>QWidget::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 QWidget 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">QCursor</a> & <a name="cursor"></a>QWidget::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>QWidget::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>QWidget::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 QWidget destructor. + +<h3 class=fn>void <a name="dragEnterEvent"></a>QWidget::dragEnterEvent ( <a href="qdragenterevent.html">QDragEnterEvent</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">QTextDrag</a>, <a href="qimagedrag.html">QImageDrag</a>, and <a href="qdragenterevent.html">QDragEnterEvent</a>. + +<p>Example: <a href="simple_dd-example.html#x2829">iconview/simple_dd/main.cpp</a>. +<h3 class=fn>void <a name="dragLeaveEvent"></a>QWidget::dragLeaveEvent ( <a href="qdragleaveevent.html">QDragLeaveEvent</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">QTextDrag</a>, <a href="qimagedrag.html">QImageDrag</a>, and <a href="qdragleaveevent.html">QDragLeaveEvent</a>. + +<h3 class=fn>void <a name="dragMoveEvent"></a>QWidget::dragMoveEvent ( <a href="qdragmoveevent.html">QDragMoveEvent</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">QTextDrag</a>, <a href="qimagedrag.html">QImageDrag</a>, and <a href="qdragmoveevent.html">QDragMoveEvent</a>. + +<h3 class=fn>void <a name="drawText"></a>QWidget::drawText ( int x, int y, const <a href="qstring.html">QString</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">QPainter::drawText</a>(). + +<h3 class=fn>void <a name="drawText-2"></a>QWidget::drawText ( const <a href="qpoint.html">QPoint</a> & pos, const <a href="qstring.html">QString</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>QWidget::dropEvent ( <a href="qdropevent.html">QDropEvent</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">QTextDrag</a>, <a href="qimagedrag.html">QImageDrag</a>, and <a href="qdropevent.html">QDropEvent</a>. + +<p>Example: <a href="simple_dd-example.html#x2830">iconview/simple_dd/main.cpp</a>. +<h3 class=fn>void <a name="enabledChange"></a>QWidget::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>QWidget::enterEvent ( <a href="qevent.html">QEvent</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>QWidget::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>QWidget::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>QWidget::erase ( const <a href="qrect.html">QRect</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>QWidget::erase ( const <a href="qregion.html">QRegion</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">QColor</a> & <a name="eraseColor"></a>QWidget::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">QPixmap</a> * <a name="erasePixmap"></a>QWidget::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>QWidget::event ( <a href="qevent.html">QEvent</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">QObject::event</a>(), and <a href="qobject.html#timerEvent">QObject::timerEvent</a>(). + +<p>Reimplemented from <a href="qobject.html#event">QObject</a>. +<h3 class=fn><a href="qwidget.html">QWidget</a> * <a name="find"></a>QWidget::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">QFocusData</a> * <a name="focusData"></a>QWidget::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>QWidget::focusInEvent ( <a href="qfocusevent.html">QFocusEvent</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">QFocusEvent</a>. + +<h3 class=fn>bool <a name="focusNextPrevChild"></a>QWidget::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">QWidget::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">QScrollView</a> uses it own logic for this function, which +does the right thing in most cases. But if you are using a +QScrollView and want complete control of the focus chain you'll +need to override <a href="#focusNextPrevChild">QScrollView::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>QWidget::focusOutEvent ( <a href="qfocusevent.html">QFocusEvent</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">QFocusEvent</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>QWidget::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">QWidget</a> * <a name="focusProxy"></a>QWidget::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">QWidget</a> * <a name="focusWidget"></a>QWidget::focusWidget () const +</h3> +Returns the focus widget in this widget's window. This is not the +same as <a href="qapplication.html#focusWidget">QApplication::focusWidget</a>(), which returns the focus +widget in the currently active window. + +<h3 class=fn><a href="qfont.html">QFont</a> <a name="font"></a>QWidget::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>QWidget::fontChange ( const <a href="qfont.html">QFont</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">QFontInfo</a> <a name="fontInfo"></a>QWidget::fontInfo () const +</h3> + +<p> Returns the font info for the widget's current font. +Equivalent to QFontInto(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">QFontMetrics</a> <a name="fontMetrics"></a>QWidget::fontMetrics () const +</h3> + +<p> Returns the font metrics for the widget's current font. +Equivalent to <a href="qfontmetrics.html">QFontMetrics</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">QColor</a> & <a name="foregroundColor"></a>QWidget::foregroundColor () const +</h3> +Same as <a href="#paletteForegroundColor">paletteForegroundColor</a>() + +<h3 class=fn><a href="qrect.html">QRect</a> <a name="frameGeometry"></a>QWidget::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">QSize</a> <a name="frameSize"></a>QWidget::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">QRect</a> & <a name="geometry"></a>QWidget::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>QWidget::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">Qt::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>QWidget::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>QWidget::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 Qt, as +Qt grabs and releases it sensibly. In particular, Qt 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>QWidget::grabMouse ( const <a href="qcursor.html">QCursor</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>QWidget::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>QWidget::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>QWidget::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>QWidget::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>QWidget::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">QMenuBar</a> and <a href="qtextedit.html#heightForWidth">QTextEdit</a>. +<h3 class=fn>void <a name="hide"></a>QWidget::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">QMenuBar</a>. +<h3 class=fn>void <a name="hideEvent"></a>QWidget::hideEvent ( <a href="qhideevent.html">QHideEvent</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">QHideEvent</a>. + +<p>Reimplemented in <a href="qscrollbar.html#hideEvent">QScrollBar</a>. +<h3 class=fn>const <a href="qpixmap.html">QPixmap</a> * <a name="icon"></a>QWidget::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">QString</a> <a name="iconText"></a>QWidget::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>QWidget::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>QWidget::imComposeEvent ( <a href="qimevent.html">QIMEvent</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">QIMEvent</a> documentation for more +details. +<p> <p>See also <a href="#event">event</a>() and <a href="qimevent.html">QIMEvent</a>. + +<h3 class=fn>void <a name="imEndEvent"></a>QWidget::imEndEvent ( <a href="qimevent.html">QIMEvent</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">QIMEvent</a> documentation for more +details. +<p> <p>See also <a href="#event">event</a>() and <a href="qimevent.html">QIMEvent</a>. + +<h3 class=fn>void <a name="imStartEvent"></a>QWidget::imStartEvent ( <a href="qimevent.html">QIMEvent</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">QIMEvent</a> documentation for more +details. +<p> <p>See also <a href="#event">event</a>() and <a href="qimevent.html">QIMEvent</a>. + +<h3 class=fn>bool <a name="isActiveWindow"></a>QWidget::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>QWidget::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>QWidget::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>QWidget::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>QWidget::isEnabledTo ( <a href="qwidget.html">QWidget</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>QWidget::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>QWidget::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>QWidget::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>QWidget::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>QWidget::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>QWidget::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>QWidget::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>QWidget::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>QWidget::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>QWidget::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>QWidget::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>QWidget::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>QWidget::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>QWidget::isVisibleTo ( <a href="qwidget.html">QWidget</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>QWidget::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>QWidget::keyPressEvent ( <a href="qkeyevent.html">QKeyEvent</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">QKeyEvent::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">QKeyEvent</a>. + +<p>Example: <a href="picture-example.html#x127">picture/picture.cpp</a>. +<p>Reimplemented in <a href="qlineedit.html#keyPressEvent">QLineEdit</a> and <a href="qtextedit.html#keyPressEvent">QTextEdit</a>. +<h3 class=fn>void <a name="keyReleaseEvent"></a>QWidget::keyReleaseEvent ( <a href="qkeyevent.html">QKeyEvent</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">QKeyEvent::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">QKeyEvent</a>. + +<h3 class=fn><a href="qwidget.html">QWidget</a> * <a name="keyboardGrabber"></a>QWidget::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">QLayout</a> * <a name="layout"></a>QWidget::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>QWidget::leaveEvent ( <a href="qevent.html">QEvent</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>QWidget::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>QWidget::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 Qt, return TRUE. If you return FALSE, this +native event is passed back to Qt, which translates the event into +a Qt 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">QApplication::macEventFilter</a>(). + +<h3 class=fn><a href="qpoint.html">QPoint</a> <a name="mapFrom"></a>QWidget::mapFrom ( <a href="qwidget.html">QWidget</a> * parent, const <a href="qpoint.html">QPoint</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">QPoint</a> <a name="mapFromGlobal"></a>QWidget::mapFromGlobal ( const <a href="qpoint.html">QPoint</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">QPoint</a> <a name="mapFromParent"></a>QWidget::mapFromParent ( const <a href="qpoint.html">QPoint</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">QPoint</a> <a name="mapTo"></a>QWidget::mapTo ( <a href="qwidget.html">QWidget</a> * parent, const <a href="qpoint.html">QPoint</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">QPoint</a> <a name="mapToGlobal"></a>QWidget::mapToGlobal ( const <a href="qpoint.html">QPoint</a> & pos ) const +</h3> +Translates the widget coordinate <em>pos</em> to global screen +coordinates. For example, <tt>mapToGlobal(QPoint(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">QPoint</a> <a name="mapToParent"></a>QWidget::mapToParent ( const <a href="qpoint.html">QPoint</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>QWidget::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">QSize</a> <a name="maximumSize"></a>QWidget::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>QWidget::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>QWidget::metric ( int m ) const<tt> [virtual protected]</tt> +</h3> +Internal implementation of the virtual QPaintDevice::metric() +function. +<p> Use the <a href="qpaintdevicemetrics.html">QPaintDeviceMetrics</a> class instead. +<p> <em>m</em> is the metric to get. + +<h3 class=fn><a href="qrect.html">QRect</a> <a name="microFocusHint"></a>QWidget::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>QWidget::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">QSize</a> <a name="minimumSize"></a>QWidget::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">QSize</a> <a name="minimumSizeHint"></a>QWidget::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">QLineEdit</a>. +<h3 class=fn>int <a name="minimumWidth"></a>QWidget::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>QWidget::mouseDoubleClickEvent ( <a href="qmouseevent.html">QMouseEvent</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">QMouseEvent</a>. + +<h3 class=fn><a href="qwidget.html">QWidget</a> * <a name="mouseGrabber"></a>QWidget::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>QWidget::mouseMoveEvent ( <a href="qmouseevent.html">QMouseEvent</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">QMouseEvent::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 Qt. +<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">QMouseEvent</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">QSizeGrip</a>. +<h3 class=fn>void <a name="mousePressEvent"></a>QWidget::mousePressEvent ( <a href="qmouseevent.html">QMouseEvent</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">QMouseEvent</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">QSizeGrip</a>. +<h3 class=fn>void <a name="mouseReleaseEvent"></a>QWidget::mouseReleaseEvent ( <a href="qmouseevent.html">QMouseEvent</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">QMouseEvent</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>QWidget::move ( const <a href="qpoint.html">QPoint</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>QWidget::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">QPoint</a>(<em>x</em>, <em>y</em>) ). + +<h3 class=fn>void <a name="moveEvent"></a>QWidget::moveEvent ( <a href="qmoveevent.html">QMoveEvent</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">QMoveEvent::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">QMoveEvent</a>. + +<h3 class=fn>bool <a name="ownCursor"></a>QWidget::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>QWidget::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>QWidget::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>QWidget::paintEvent ( <a href="qpaintevent.html">QPaintEvent</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">QPaintEvent::region</a>(). This speed optimization +does not change the result, as painting is clipped to that region +during event processing. <a href="qlistview.html">QListView</a> and <a href="qcanvas.html">QCanvas</a> do this, for +example. +<p> Qt 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, Qt merges these events +into one event with a larger region (see <a href="qregion.html#unite">QRegion::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">QPaintEvent::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">QPainter</a>, <a href="qpixmap.html">QPixmap</a>, and <a href="qpaintevent.html">QPaintEvent</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">QButton</a>, <a href="qframe.html#paintEvent">QFrame</a>, <a href="qglwidget.html#paintEvent">QGLWidget</a>, <a href="qsizegrip.html#paintEvent">QSizeGrip</a>, <a href="qstatusbar.html#paintEvent">QStatusBar</a>, and <a href="qtabbar.html#paintEvent">QTabBar</a>. +<h3 class=fn>const <a href="qpalette.html">QPalette</a> & <a name="palette"></a>QWidget::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">QColor</a> & <a name="paletteBackgroundColor"></a>QWidget::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">QPixmap</a> * <a name="paletteBackgroundPixmap"></a>QWidget::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>QWidget::paletteChange ( const <a href="qpalette.html">QPalette</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">QColor</a> & <a name="paletteForegroundColor"></a>QWidget::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">QWidget</a> * <a name="parentWidget"></a>QWidget::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>QWidget::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">QApplication::polish</a>() has been called. +<p> Remember to call QWidget'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">QApplication::polish</a>(). + +<p>Example: <a href="menu-example.html#x1883">menu/menu.cpp</a>. +<h3 class=fn><a href="qpoint.html">QPoint</a> <a name="pos"></a>QWidget::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>QWidget::qwsEvent ( QWSEvent * )<tt> [virtual protected]</tt> +</h3> +This special event handler can be reimplemented in a subclass to +receive native Qt/Embedded events. +<p> In your reimplementation of this function, if you want to stop the +event being handled by Qt, return TRUE. If you return FALSE, this +native event is passed back to Qt, which translates the event into +a Qt 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">QApplication::qwsEventFilter</a>(). + +<h3 class=fn>void <a name="raise"></a>QWidget::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>QWidget::recreate ( <a href="qwidget.html">QWidget</a> * parent, WFlags f, const <a href="qpoint.html">QPoint</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 Qt 1.0 to 2.0. It has +been renamed <a href="#reparent">reparent</a>() in Qt 2.0. + +<h3 class=fn><a href="qrect.html">QRect</a> <a name="rect"></a>QWidget::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>QWidget::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>QWidget::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>QWidget::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, Qt 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 Qt 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>QWidget::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>QWidget::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>QWidget::repaint ( const <a href="qrect.html">QRect</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>QWidget::repaint ( const <a href="qregion.html">QRegion</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>QWidget::reparent ( <a href="qwidget.html">QWidget</a> * parent, WFlags f, const <a href="qpoint.html">QPoint</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">QWidgetStack</a> or <a href="qwizard.html">QWizard</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>QWidget::reparent ( <a href="qwidget.html">QWidget</a> * parent, const <a href="qpoint.html">QPoint</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>QWidget::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>QWidget::resize ( const <a href="qsize.html">QSize</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>QWidget::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">QSize</a>(<em>w</em>, <em>h</em>) ). + +<h3 class=fn>void <a name="resizeEvent"></a>QWidget::resizeEvent ( <a href="qresizeevent.html">QResizeEvent</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">QResizeEvent::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">QResizeEvent</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">QFrame</a> and <a href="qglwidget.html#resizeEvent">QGLWidget</a>. +<h3 class=fn>void <a name="scroll"></a>QWidget::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">QApplication::sendPostedEvents</a>() +when using scroll() and <a href="#move">move</a>() in combination). +<p> <p>See also <a href="qscrollview.html">QScrollView</a>, <a href="#erase">erase</a>(), and <a href="qpaintdevice.html#bitBlt">bitBlt</a>(). + +<h3 class=fn>void <a name="scroll-2"></a>QWidget::scroll ( int dx, int dy, const <a href="qrect.html">QRect</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">QScrollView</a>, <a href="#erase">erase</a>(), and <a href="qpaintdevice.html#bitBlt">bitBlt</a>(). + +<h3 class=fn>void <a name="setAcceptDrops"></a>QWidget::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>QWidget::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">QXtWidget</a>. +<h3 class=fn>void <a name="setAutoMask"></a>QWidget::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>QWidget::setBackgroundColor ( const <a href="qcolor.html">QColor</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>QWidget::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>QWidget::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>Qt Designer</em>. + +<h3 class=fn>void <a name="setBackgroundOrigin"></a>QWidget::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>QWidget::setBackgroundPixmap ( const <a href="qpixmap.html">QPixmap</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>QWidget::setBaseSize ( const <a href="qsize.html">QSize</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>QWidget::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">QSize</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>QWidget::setCaption ( const <a href="qstring.html">QString</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>QWidget::setCursor ( const <a href="qcursor.html">QCursor</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>QWidget::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">QKeyEvent</a>, <a href="qmouseevent.html">QMouseEvent</a>, and <a href="#enabledChange">enabledChange</a>(). + +<h3 class=fn>void <a name="setEnabled"></a>QWidget::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>QWidget::setEraseColor ( const <a href="qcolor.html">QColor</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>QWidget::setErasePixmap ( const <a href="qpixmap.html">QPixmap</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>QWidget::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>QWidget::setFixedSize ( const <a href="qsize.html">QSize</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>QWidget::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>QWidget::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>QWidget::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">QApplication::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>QWidget::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>QWidget::setFocusProxy ( <a href="qwidget.html">QWidget</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">QComboBox</a>, can "have focus", but create a +child widget to actually handle the focus. QComboBox, for example, +creates a <a href="qlineedit.html">QLineEdit</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>QWidget::setFont ( const <a href="qfont.html">QFont</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">QComboBox</a>, <a href="qlabel.html#setFont">QLabel</a>, and <a href="qtabdialog.html#setFont">QTabDialog</a>. +<h3 class=fn>void <a name="setFont-2"></a>QWidget::setFont ( const <a href="qfont.html">QFont</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">QFont</a>& font) instead. + +<h3 class=fn>void <a name="setGeometry"></a>QWidget::setGeometry ( const <a href="qrect.html">QRect</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>QWidget::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">QRect</a>(<em>x</em>, <em>y</em>, <em>w</em>, <em>h</em>) ). + +<h3 class=fn>void <a name="setHidden"></a>QWidget::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>QWidget::setIcon ( const <a href="qpixmap.html">QPixmap</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>QWidget::setIconText ( const <a href="qstring.html">QString</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>QWidget::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>QWidget::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">QLineEdit</a> and +<a href="qtextedit.html">QTextEdit</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, Qt 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">QKeyEvent::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> Qt 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">QKeyEvent::text</a>(). + +<h3 class=fn>void <a name="setMask"></a>QWidget::setMask ( const <a href="qbitmap.html">QBitmap</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 Qt::color0 to draw +transparent regions and Qt::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>QWidget::setMask ( const <a href="qregion.html">QRegion</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>QWidget::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>QWidget::setMaximumSize ( const <a href="qsize.html">QSize</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>QWidget::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">QSize</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>QWidget::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>QWidget::setMicroFocusHint ( int x, int y, int width, int height, bool text = TRUE, <a href="qfont.html">QFont</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 Qt, 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 Qt, 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>QWidget::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>QWidget::setMinimumSize ( const <a href="qsize.html">QSize</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>QWidget::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">QSize</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>QWidget::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>QWidget::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>QWidget::setPalette ( const <a href="qpalette.html">QPalette</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">QComboBox</a>, <a href="qscrollbar.html#setPalette">QScrollBar</a>, and <a href="qslider.html#setPalette">QSlider</a>. +<h3 class=fn>void <a name="setPalette-2"></a>QWidget::setPalette ( const <a href="qpalette.html">QPalette</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">QPalette</a>& p ) instead. + +<h3 class=fn>void <a name="setPaletteBackgroundColor"></a>QWidget::setPaletteBackgroundColor ( const <a href="qcolor.html">QColor</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>QWidget::setPaletteBackgroundPixmap ( const <a href="qpixmap.html">QPixmap</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>QWidget::setPaletteForegroundColor ( const <a href="qcolor.html">QColor</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>QWidget::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>QWidget::setSizeIncrement ( const <a href="qsize.html">QSize</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>QWidget::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>QWidget::setSizePolicy ( <a href="qsizepolicy.html">QSizePolicy</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>QWidget::setSizePolicy ( <a href="qsizepolicy.html#SizeType-enum">QSizePolicy::SizeType</a> hor, <a href="qsizepolicy.html#SizeType-enum">QSizePolicy::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#QSizePolicy">QSizePolicy::QSizePolicy</a>(). + +<h3 class=fn>void <a name="setStyle"></a>QWidget::setStyle ( <a href="qstyle.html">QStyle</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">QApplication::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 Qt'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">QStyle</a>, <a href="qapplication.html#style">QApplication::style</a>(), and <a href="qapplication.html#setStyle">QApplication::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">QStyle</a> * <a name="setStyle-2"></a>QWidget::setStyle ( const <a href="qstring.html">QString</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">QStyleFactory</a>. + +<h3 class=fn>void <a name="setTabOrder"></a>QWidget::setTabOrder ( <a href="qwidget.html">QWidget</a> * first, <a href="qwidget.html">QWidget</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>QWidget::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>QWidget::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">Qt::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>QWidget::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>QWidget::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 Qt::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">Qt::WindowState</a> and <a href="#windowState">windowState</a>(). + +<h3 class=fn>void <a name="show"></a>QWidget::show ()<tt> [virtual slot]</tt> +</h3> +Shows the widget and its child widgets. +<p> If its size or position has changed, Qt 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">QDialog</a> and <a href="qmenubar.html#show">QMenuBar</a>. +<h3 class=fn>void <a name="showEvent"></a>QWidget::showEvent ( <a href="qshowevent.html">QShowEvent</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">QShowEvent</a>. + +<p>Example: <a href="qdir-example.html#x1854">qdir/qdir.cpp</a>. +<h3 class=fn>void <a name="showFullScreen"></a>QWidget::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>QWidget::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>QWidget::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>QWidget::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">QSize</a> <a name="size"></a>QWidget::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">QSize</a> <a name="sizeHint"></a>QWidget::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">QSizeGrip</a>. +<h3 class=fn><a href="qsize.html">QSize</a> <a name="sizeIncrement"></a>QWidget::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">QSizePolicy</a> <a name="sizePolicy"></a>QWidget::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>QWidget::stackUnder ( <a href="qwidget.html">QWidget</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">QStyle</a> & <a name="style"></a>QWidget::style () const +</h3> +Returns the GUI style for this widget +<p> <p>See also <a href="#setStyle">QWidget::setStyle</a>(), <a href="qapplication.html#setStyle">QApplication::setStyle</a>(), and <a href="qapplication.html#style">QApplication::style</a>(). + +<h3 class=fn>void <a name="styleChange"></a>QWidget::styleChange ( <a href="qstyle.html">QStyle</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">QApplication::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>QWidget::tabletEvent ( <a href="qtabletevent.html">QTabletEvent</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">QTabletEvent::ignore</a>(), <a href="qtabletevent.html#accept">QTabletEvent::accept</a>(), <a href="#event">event</a>(), and <a href="qtabletevent.html">QTabletEvent</a>. + +<h3 class=fn>WFlags <a name="testWFlags"></a>QWidget::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">Qt::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">QWidget</a> * <a name="topLevelWidget"></a>QWidget::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>QWidget::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>QWidget::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>QWidget::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>QWidget::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 Qt returns to the main +event loop. This permits Qt 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> Qt 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>QWidget::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 Qt returns to the main +event loop. This permits Qt 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> Qt 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>QWidget::update ( const <a href="qrect.html">QRect</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 Qt returns to the main +event loop. This permits Qt 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>QWidget::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>QWidget::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">QRect</a> <a name="visibleRect"></a>QWidget::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>QWidget::wheelEvent ( <a href="qwheelevent.html">QWheelEvent</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">QWheelEvent::ignore</a>(), <a href="qwheelevent.html#accept">QWheelEvent::accept</a>(), <a href="#event">event</a>(), and <a href="qwheelevent.html">QWheelEvent</a>. + +<h3 class=fn>int <a name="width"></a>QWidget::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>QWidget::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 Qt, return TRUE. If you return FALSE, this +native event is passed back to Qt, which translates the event into +a Qt 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">QApplication::winEventFilter</a>(). + +<h3 class=fn>WId <a name="winId"></a>QWidget::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>QWidget::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>QWidget::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>QWidget::windowState () const +</h3> Returns the current <a href="qt.html#WindowState">window state</a>. The window state is a OR'ed +combination of Qt::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">Qt::WindowState</a> and <a href="#setWindowState">setWindowState</a>(). + +<h3 class=fn>int <a name="x"></a>QWidget::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>QWidget::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 Qt, return TRUE. If you return FALSE, this +native event is passed back to Qt, which translates the event into +a Qt 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">QApplication::x11EventFilter</a>(). + +<p>Reimplemented in <a href="qxtwidget.html#x11Event">QXtWidget</a>. +<h3 class=fn>int <a name="y"></a>QWidget::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">QWidget::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. +QWidget 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">QBrush</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">QApplication::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">QListBox</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 Qt, 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">QSize</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">QString</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#QString-null">QString::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">QRect</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">QRegion</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">QColorGroup</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">QPalette::disabled</a>() color group, a widget +with <a href="focus.html#keyboard-focus">keyboard focus</a> has the <a href="qpalette.html#active">QPalette::active</a>() color group, and an +inactive widget has the <a href="qpalette.html#inactive">QPalette::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">QCursor</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">QApplication::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">QWhatsThis::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 QWhatsThis::leaveWhatsThisMode() in that case. +<p> <p>See also <a href="qwhatsthis.html#inWhatsThisMode">QWhatsThis::inWhatsThisMode</a>() and <a href="qwhatsthis.html#leaveWhatsThisMode">QWhatsThis::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">QKeyEvent</a>, <a href="qmouseevent.html">QMouseEvent</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">QApplication::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">QWidget::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">QLineEdit</a> constructor calls +<a href="#setFocusPolicy">setFocusPolicy</a>(QWidget::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">QWidget::TabFocus</a> if the widget accepts keyboard +focus by tabbing, <a href="#FocusPolicy-enum">QWidget::ClickFocus</a> if the widget accepts +focus by clicking, <a href="#FocusPolicy-enum">QWidget::StrongFocus</a> if it accepts both, and +<a href="#FocusPolicy-enum">QWidget::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">QLineEdit</a> constructor calls +<a href="#setFocusPolicy">setFocusPolicy</a>(QWidget::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">QFont</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">QFont</a> f( "Helvetica", 12, QFont::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">QRect</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">QSize</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">QRect</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 Qt 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">QPixmap</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">QString</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#QString-null">QString::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">QApplication::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">QApplication::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">QDialog</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">QDialog</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">QDialog</a> and <a href="qmainwindow.html">QMainWindow</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, Qt 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">QSize</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">QRect</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">QSize</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 QLayout::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">QLayout::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">QSize</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">QLayout</a> will never resize a widget to a size smaller than +minimumSizeHint. +<p> <p>See also <a href="qsize.html#isValid">QSize::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">QApplication::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">QPalette</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">QApplication::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">QColor</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">QPalette</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">QColorGroup::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">QPixmap</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">QPalette</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">QColorGroup::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">QColor</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">QPalette</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">QColorGroup::ButtonText</a> is set to color. +<p> <p>See also <a href="#palette-prop">palette</a>, <a href="qapplication.html#setPalette">QApplication::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">QPoint</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 Qt 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">QRect</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">QRect</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">QSize</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">QSize</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( QLayout::FreeResize ) on its layout. +<p> <a href="#resize">resize</a>() is virtual, and all other overloaded resize() +implementations in Qt 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">QSize</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">QSize::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">QSize</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">QSizePolicy</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">QLayout</a> that manages this widget's children, the +size policy specified by that layout is used. If there is no such +QLayout, 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">QLineEdit</a>, <a href="qspinbox.html">QSpinBox</a> or an editable <a href="qcombobox.html">QComboBox</a>) and other +horizontally orientated widgets (such as <a href="qprogressbar.html">QProgressBar</a>). +<a href="qtoolbutton.html">QToolButton</a>'s are normally square, so they allow growth in both +directions. Widgets that support different directions (such as +<a href="qslider.html">QSlider</a>, <a href="qscrollbar.html">QScrollBar</a> or <a href="qheader.html">QHeader</a>) specify stretching in the +respective direction only. Widgets that can provide scrollbars +(usually subclasses of <a href="qscrollview.html">QScrollView</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">QLayout</a>, <a href="qsizepolicy.html">QSizePolicy</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">QEvent::Enter</a> and <a href="qevent.html#Type-enum">QEvent::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">QRect</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">QPixmap::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">Qt 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>Qt 3.3.8</div> +</table></div></address></body> +</html> |