|  | Home · All Classes · Main Classes · Grouped Classes · Modules · Functions |

# Qt 3 Support Members for QWidget

The following class members are part of the Qt 3 support layer. They are provided to help you port old code to Qt 4. We advise against using them in new code.

- QWidget class reference

### Public Types

- enum BackgroundOrigin { WidgetOrigin, ParentOrigin, WindowOrigin, AncestorOrigin }

### Public Functions

- QWidget ( QWidget * parent, const char * name, Qt::WindowFlags f = 0 )
- Qt::BackgroundMode backgroundMode () const
- QPoint backgroundOffset () const
- BackgroundOrigin backgroundOrigin () const
- QString caption () const
- QWidget * childAt ( int x, int y, bool includeThis ) const
- QWidget * childAt ( const QPoint & p, bool includeThis ) const
- bool close ( bool alsoDelete )
- QColorGroup colorGroup () const
- void constPolish () const
- void drawText ( const QPoint & p, const QString & s )
- void drawText ( int x, int y, const QString & s )
- void erase ()
- void erase ( int x, int y, int w, int h )
- void erase ( const QRect & rect )
- void erase ( const QRegion & rgn )
- bool hasMouse () const
- const QPixmap * icon () const
- QString iconText () const
- void iconify ()
- bool isDesktop () const
- bool isDialog () const
- bool isInputMethodEnabled () const
- bool isPopup () const
- bool isShown () const
- bool isUpdatesEnabled () const
- bool isVisibleToTLW () const
- bool ownCursor () const
- bool ownFont () const
- bool ownPalette () const
- QWidget * parentWidget ( bool sameWindow ) const
- void polish ()
- void recreate ( QWidget * parent, Qt::WindowFlags f, const QPoint & p, bool showIt = false )
- void repaint ( bool b )
- void repaint ( int x, int y, int w, int h, bool b )
- void repaint ( const QRect & r, bool b )
- void repaint ( const QRegion & rgn, bool b )
- void reparent ( QWidget * parent, Qt::WindowFlags f, const QPoint & p, bool showIt = false )
- void reparent ( QWidget * parent, const QPoint & p, bool showIt = false )
- void setActiveWindow ()
- void setBackgroundColor ( const QColor & color )
- void setBackgroundMode ( Qt::BackgroundMode widgetBackground, Qt::BackgroundMode paletteBackground = Qt::PaletteBackground )
- void setBackgroundOrigin ( BackgroundOrigin background )
- void setBackgroundPixmap ( const QPixmap & pixmap )
- void setCaption ( const QString & c )
- void setEraseColor ( const QColor & color )
- void setErasePixmap ( const QPixmap & pixmap )
- void setFont ( const QFont & f, bool b )
- void setIcon ( const QPixmap & i )
- void setIconText ( const QString & it )
- void setInputMethodEnabled ( bool enabled )
- void setKeyCompression ( bool b )
- void setPalette ( const QPalette & p, bool b )
- void setPaletteBackgroundColor ( const QColor & color )
- void setPaletteBackgroundPixmap ( const QPixmap & pixmap )
- void setPaletteForegroundColor ( const QColor & color )
- void setSizePolicy ( QSizePolicy::Policy hor, QSizePolicy::Policy ver, bool hfw )
- QStyle * setStyle ( const QString & style )
- void unsetFont ()
- void unsetPalette ()
- QRect visibleRect () const

- 8 public functions inherited from QObject
- 8 public functions inherited from QPaintDevice

### Public Slots

- void setShown ( bool shown )

### Static Public Members

- QWidgetMapper * wmapper ()

- 13 static public members inherited from QPaintDevice

## Member Type Documentation

### enum QWidget::BackgroundOrigin

Constant | Value
--- | ---
`QWidget::WidgetOrigin` | `0`
`QWidget::ParentOrigin` | `1`
`QWidget::WindowOrigin` | `2`
`QWidget::AncestorOrigin` | `3`

## Member Function Documentation

### QWidget::QWidget ( QWidget * parent, const char * name, Qt::WindowFlags f = 0 )

### Qt::BackgroundMode QWidget::backgroundMode () const

Returns the color role used for painting the widget's background.

Use QPalette(backgroundRole(()) instead.

See also setBackgroundMode().

### QPoint QWidget::backgroundOffset () const

Always returns QPoint().

### BackgroundOrigin QWidget::backgroundOrigin () const

Always returns `WindowOrigin`.

See also setBackgroundOrigin().

### QString QWidget::caption () const

Use windowTitle() instead.

See also setCaption().

### QWidget * QWidget::childAt ( int x, int y, bool includeThis ) const

This is an overloaded member function, provided for convenience.

Use the childAt() overload that doesn't have an includeThis parameter.

For example, if you have code like

     return widget->childAt(x, y, true);

you can rewrite it as

     QWidget *child = widget->childAt(x, y, true);
     if (child)
         return child;
     if (widget->rect().contains(x, y))
         return widget;

### QWidget * QWidget::childAt ( const QPoint & p, bool includeThis ) const

This is an overloaded member function, provided for convenience.

Use the single point argument overload instead.

### bool QWidget::close ( bool alsoDelete )

This is an overloaded member function, provided for convenience.

Closes the widget.

Use the no-argument overload instead.

### QColorGroup QWidget::colorGroup () const

Use QColorGroup(palette()) instead.

### void QWidget::constPolish () const

Use ensurePolished() instead.

### void QWidget::drawText ( const QPoint & p, const QString & s )

Drawing may only take place in a QPaintEvent. Overload paintEvent() to do your drawing and call update() to schedule a replaint whenever necessary. See also QPainter.

### void QWidget::drawText ( int x, int y, const QString & s )

This is an overloaded member function, provided for convenience.

Drawing may only take place in a QPaintEvent. Overload paintEvent() to do your drawing and call update() to schedule a replaint whenever necessary. See also QPainter.

### void QWidget::erase ()

Drawing may only take place in a QPaintEvent. Overload paintEvent() to do your erasing and call update() to schedule a replaint whenever necessary. See also QPainter.

### void QWidget::erase ( int x, int y, int w, int h )

This is an overloaded member function, provided for convenience.

Drawing may only take place in a QPaintEvent. Overload paintEvent() to do your erasing and call update() to schedule a replaint whenever necessary. See also QPainter.

### void QWidget::erase ( const QRect & rect )

This is an overloaded member function, provided for convenience.

Drawing may only take place in a QPaintEvent. Overload paintEvent() to do your erasing and call update() to schedule a replaint whenever necessary. See also QPainter.

### void QWidget::erase ( const QRegion & rgn )

This is an overloaded member function, provided for convenience.

Clear the given region, rgn.

Drawing may only take place in a QPaintEvent. Overload paintEvent() to do your erasing and call update() to schedule a replaint whenever necessary. See also QPainter.

### bool QWidget::hasMouse () const

Use testAttribute(Qt::WA_UnderMouse) instead.

### const QPixmap * QWidget::icon () const

Return's the widget's icon.

Use windowIcon() instead().

See also setIcon().

### QString QWidget::iconText () const

Use windowIconText() instead().

See also setIconText().

### void QWidget::iconify ()

Use showMinimized() instead.

### bool QWidget::isDesktop () const

Use windowType() == Qt::Desktop instead.

### bool QWidget::isDialog () const

Use windowType() == Qt::Dialog instead.

### bool QWidget::isInputMethodEnabled () const

Use testAttribute(Qt::WA_InputMethodEnabled) instead.

### bool QWidget::isPopup () const

Use windowType() == Qt::Popup instead.

### bool QWidget::isShown () const

Use !isHidden() instead (notice the exclamation mark), or use isVisible() to check whether the widget is visible.

### bool QWidget::isUpdatesEnabled () const

Use the updatesEnabled property instead.

### bool QWidget::isVisibleToTLW () const

Use isVisible() instead.

### bool QWidget::ownCursor () const

Use testAttribute(Qt::WA_SetCursor) instead.

### bool QWidget::ownFont () const

Use testAttribute(Qt::WA_SetFont) instead.

### bool QWidget::ownPalette () const

Use testAttribute(Qt::WA_SetPalette) instead.

### QWidget * QWidget::parentWidget ( bool sameWindow ) const

This is an overloaded member function, provided for convenience.

Use the no-argument overload instead.

### void QWidget::polish ()

Use ensurePolished() instead.

### void QWidget::recreate ( QWidget * parent, Qt::WindowFlags f, const QPoint & p, bool showIt = false )

Use setParent() to change the parent or the widget's widget flags; use move() to move the widget, and use show() to show the widget.

### void QWidget::repaint ( bool b )

This is an overloaded member function, provided for convenience.

The boolean parameter b is ignored. Use the no-argument overload instead.

### void QWidget::repaint ( int x, int y, int w, int h, bool b )

This is an overloaded member function, provided for convenience.

The boolean parameter b is ignored. Use the four-argument overload instead.

### void QWidget::repaint ( const QRect & r, bool b )

This is an overloaded member function, provided for convenience.

The boolean parameter b is ignored. Use the single rect-argument overload instead.

### void QWidget::repaint ( const QRegion & rgn, bool b )

This is an overloaded member function, provided for convenience.

The boolean parameter b is ignored. Use the single region-argument overload instead.

### void QWidget::reparent ( QWidget * parent, Qt::WindowFlags f, const QPoint & p, bool showIt = false )

Use setParent() to change the parent or the widget's widget flags; use move() to move the widget, and use show() to show the widget.

### void QWidget::reparent ( QWidget * parent, const QPoint & p, bool showIt = false )

This is an overloaded member function, provided for convenience.

Use setParent() to change the parent; use move() to move the widget, and use show() to show the widget.

### void QWidget::setActiveWindow ()

Use activateWindow() instead.

See also isActiveWindow().

### void QWidget::setBackgroundColor ( const QColor & color )

Use the palette instead.

For example, if you have code like

     widget->setBackgroundColor(color);

you can rewrite it as

     QPalette palette;
     palette.setColor(widget->backgroundRole(), color);
     widget->setPalette(palette);

### void QWidget::setBackgroundMode ( Qt::BackgroundMode widgetBackground, Qt::BackgroundMode paletteBackground = Qt::PaletteBackground )

Sets the color role used for painting the widget's background to background mode widgetBackground. The paletteBackground mode parameter is ignored.

See also backgroundMode().

### void QWidget::setBackgroundOrigin ( BackgroundOrigin background )

See also backgroundOrigin().

### void QWidget::setBackgroundPixmap ( const QPixmap & pixmap )

Use the palette instead.

For example, if you have code like

     widget->setBackgroundPixmap(pixmap);

you can rewrite it as

     QPalette palette;
     palette.setBrush(widget->backgroundRole(), QBrush(pixmap));
     widget->setPalette(palette);

### void QWidget::setCaption ( const QString & c )

Use setWindowTitle() instead.

See also caption().

### void QWidget::setEraseColor ( const QColor & color )

Use the palette instead.

For example, if you have code like

     widget->setEraseColor(color);

you can rewrite it as

     QPalette palette;
     palette.setColor(widget->backgroundRole(), color);
     widget->setPalette(palette);

### void QWidget::setErasePixmap ( const QPixmap & pixmap )

Use the palette instead.

For example, if you have code like

     widget->setErasePixmap(pixmap);

you can rewrite it as

     QPalette palette;
     palette.setBrush(widget->backgroundRole(), QBrush(pixmap));
     widget->setPalette(palette);

### void QWidget::setFont ( const QFont & f, bool b )

This is an overloaded member function, provided for convenience.

Use the single-argument overload instead.

### void QWidget::setIcon ( const QPixmap & i )

Use setWindowIcon() instead.

See also icon().

### void QWidget::setIconText ( const QString & it )

Use setWindowIconText() instead.

See also iconText().

### void QWidget::setInputMethodEnabled ( bool enabled )

Use setAttribute(Qt::WA_InputMethodEnabled, enabled) instead.

See also isInputMethodEnabled().

### void QWidget::setKeyCompression ( bool b )

Use setAttribute(Qt::WA_KeyCompression, b) instead.

### void QWidget::setPalette ( const QPalette & p, bool b )

This is an overloaded member function, provided for convenience.

Use the single-argument overload instead.

### void QWidget::setPaletteBackgroundColor ( const QColor & color )

Use the palette directly.

For example, if you have code like

     widget->setPaletteBackgroundColor(color);

you can rewrite it as

     QPalette palette;
     palette.setColor(widget->backgroundRole(), color);
     widget->setPalette(palette);

### void QWidget::setPaletteBackgroundPixmap ( const QPixmap & pixmap )

Use the palette directly.

For example, if you have code like

     widget->setPaletteBackgroundPixmap(pixmap);

you can rewrite it as

     QPalette palette;
     palette.setBrush(widget->backgroundRole(), QBrush(pixmap));
     widget->setPalette(palette);

### void QWidget::setPaletteForegroundColor ( const QColor & color )

Use the palette directly.

For example, if you have code like

     widget->setPaletteForegroundColor(color);

you can rewrite it as

     QPalette palette;
     palette.setColor(widget->foregroundRole(), color);
     widget->setPalette(palette);

### void QWidget::setShown ( bool shown ) `[slot]`

Use setVisible(shown) instead.

See also isShown().

### void QWidget::setSizePolicy ( QSizePolicy::Policy hor, QSizePolicy::Policy ver, bool hfw )

This is an overloaded member function, provided for convenience.

Use the sizePolicy property and heightForWidth() function instead.

### QStyle * QWidget::setStyle ( const QString & style )

This is an overloaded member function, provided for convenience.

Sets the widget's GUI style to style using the QStyleFactory.

### void QWidget::unsetFont ()

Use setFont(QFont()) instead.

### void QWidget::unsetPalette ()

Use setPalette(QPalette()) instead.

### QRect QWidget::visibleRect () const

Use visibleRegion() instead.

### QWidgetMapper * QWidget::wmapper () `[static]`

The widget mapper is no longer part of the public API.