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 )

This is an overloaded function.

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

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

Use the single point argument overload instead.

bool QWidget::close ( bool alsoDelete )

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 )

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 )

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 )

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

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 )

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 )

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

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

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

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

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 )

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 )

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 )

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 )

Use the sizePolicy property and heightForWidth() function instead.

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

This is an overloaded 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.