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.

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::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.

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::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.

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.