Home · All Classes · Main Classes · Annotated · Grouped Classes · 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.

Public Types

Public Functions

Public Slots

Static Public Members


Member Type Documentation

enum QWidget::BackgroundOrigin

ConstantValue
QWidget::WidgetOrigin0
QWidget::ParentOrigin1
QWidget::WindowOrigin2
QWidget::AncestorOrigin3

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.

QPoint QWidget::backgroundOffset () const

Always returns QPoint().

BackgroundOrigin QWidget::backgroundOrigin () const

Always returns WindowOrigin.

QString QWidget::caption () const

Use windowTitle() instead.

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().

QString QWidget::iconText () const

Use windowIconText() instead().

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::isHidden () const

Use isExplicitlyHidden() 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 !isExplicitlyHidden() instead (notice the exclamation mark).

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.

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.

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.

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.

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.

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.

void QWidget::setBackgroundOrigin ( BackgroundOrigin background )

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.

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.

void QWidget::setIconText ( const QString & it )

Use setWindowIconText() instead.

void QWidget::setInputMethodEnabled ( bool enabled )

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

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.

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.

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

holds the widget's visible rectangle

QWidgetMapper * QWidget::wmapper ()   [static]

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


Copyright © 2005 Trolltech Trademarks
Qt 4.0.0-b2