|  | 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::WFlags 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::WFlags 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::WFlags 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::WFlags 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. It behaves essentially like the above function.

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. It behaves essentially like the above function.

Use the single point argument overload instead.

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

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

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. It behaves essentially like the above function.

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. It behaves essentially like the above function.

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. It behaves essentially like the above function.

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. It behaves essentially like the above function.

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 windowIconText() 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. It behaves essentially like the above function.

Use the no-argument overload instead.

### void QWidget::polish ()

Use ensurePolished() instead.

### void QWidget::recreate ( QWidget * parent, Qt::WFlags 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. It behaves essentially like the above function.

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. It behaves essentially like the above function.

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. It behaves essentially like the above function.

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. It behaves essentially like the above function.

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

### void QWidget::reparent ( QWidget * parent, Qt::WFlags 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. It behaves essentially like the above function.

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. It behaves essentially like the above function.

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. It behaves essentially like the above function.

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. It behaves essentially like the above function.

Use the sizePolicy property and heightForWidth() function instead.

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

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

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.