How to Change the Background Color of QWidget: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
m (Add call to QWidget::paintEvent(). Omitting this call may result in unexpected behavior.)
(h)
 
(One intermediate revision by one other user not shown)
Line 3: Line 3:
__NOEDITSECTION__
__NOEDITSECTION__
__NOTOC__
__NOTOC__
== Introduction ==
==Introduction==


{{DocLink|QWidget}} is the base class of all user interface objects which means that the same approaches for changing the background color can be used with them too.
{{DocLink|QWidget}} is the base class of all user interface objects which means that the same approaches for changing the background color can be used with them too.


== Using the Palette ==
==Using the Palette==


The first example demonstrates how to change the background color using {{DocLink|QPalette}}
The first example demonstrates how to change the background color using {{DocLink|QPalette}}<syntaxhighlight lang="c++">
 
<code>
m_myWidget = new QWidget(this);
m_myWidget = new QWidget(this);
m_myWidget->setGeometry(0, 0, 300, 100);
m_myWidget->setGeometry(0, 0, 300, 100);
QPalette pal = palette();
 
QPalette pal = QPalette();


// set black background
// set black background
pal.setColor(QPalette::Background, Qt::black);
// Qt::black / "#000000" / "black"
m_myWidget->setAutoFillBackground(true);
pal.setColor(QPalette::Window, Qt::black);
 
m_myWidget->setAutoFillBackground(true);  
m_myWidget->setPalette(pal);
m_myWidget->setPalette(pal);
m_myWidget->show();
m_myWidget->show();
</code>
</syntaxhighlight>
 
==Using Style Sheet==
 
'''Warning:''' Function [https://doc.qt.io/qt-5/qwidget.html#styleSheet-prop setStyleSheet] is particularly useful for demonstration purposes, where you want to show Qt's styling capabilities. Real applications should avoid it and use one consistent GUI style instead. As applicable to [https://doc.qt.io/qt-5/qwidget.html#setStyle setStyle] too.


== Using Style Sheet ==


The style sheet contains a textual description of customizations to the widget's style, as described in the [http://doc.qt.io/qt-5/stylesheet.html Qt Style Sheets document].


<code>
The style sheet contains a textual description of customizations to the widget's style, as described in the [http://doc.qt.io/qt-5/stylesheet.html Qt Style Sheets document].<syntaxhighlight lang="c++">
m_myWidget = new QWidget(this);
m_myWidget = new QWidget(this);
m_myWidget->setGeometry(0, 0, 300, 100);
m_myWidget->setGeometry(0, 0, 300, 100);
m_myWidget->setStyleSheet("background-color:black;");
m_myWidget->setStyleSheet("background-color:black;");
m_myWidget->show();
m_myWidget->show();
</code>
</syntaxhighlight>'''Note:''' If you subclass a custom widget from QWidget, then in order to use the StyleSheets you need to provide a paintEvent to the custom widget :<syntaxhighlight lang="c++">
 
Both ways to change the background color of QWidget have been successfully built using Qt SDK 1.1 and tested on Symbian devices.
 
'''Note:''' If you subclass a custom widget from QWidget, then in order to use the StyleSheets you need to provide a paintEvent to the custom widget :
 
<code>
void CustomWidget::paintEvent(QPaintEvent* event)
void CustomWidget::paintEvent(QPaintEvent* event)
{
{
QStyleOption opt;
    QStyleOption opt;
opt.init(this);
    opt.init(this);
QPainter p(this);
    QPainter p(this);
style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this);
    style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this);


QWidget::paintEvent(event);
    QWidget::paintEvent(event);
}
}
</code>
</syntaxhighlight>Both ways to change the background color of QWidget have been successfully built using Qt SDK 1.1 and tested on Symbian devices.

Latest revision as of 01:54, 13 March 2022

En Ar Bg De El Es Fa Fi Fr Hi Hu It Ja Kn Ko Ms Nl Pl Pt Ru Sq Th Tr Uk Zh


Introduction

QWidget is the base class of all user interface objects which means that the same approaches for changing the background color can be used with them too.

Using the Palette

The first example demonstrates how to change the background color using QPalette

m_myWidget = new QWidget(this);
m_myWidget->setGeometry(0, 0, 300, 100);

QPalette pal = QPalette();

// set black background
// Qt::black / "#000000" / "black"
pal.setColor(QPalette::Window, Qt::black);

m_myWidget->setAutoFillBackground(true); 
m_myWidget->setPalette(pal);
m_myWidget->show();

Using Style Sheet

Warning: Function setStyleSheet is particularly useful for demonstration purposes, where you want to show Qt's styling capabilities. Real applications should avoid it and use one consistent GUI style instead. As applicable to setStyle too.


The style sheet contains a textual description of customizations to the widget's style, as described in the Qt Style Sheets document.

m_myWidget = new QWidget(this);
m_myWidget->setGeometry(0, 0, 300, 100);
m_myWidget->setStyleSheet("background-color:black;");
m_myWidget->show();

Note: If you subclass a custom widget from QWidget, then in order to use the StyleSheets you need to provide a paintEvent to the custom widget :

void CustomWidget::paintEvent(QPaintEvent* event)
{
    QStyleOption opt;
    opt.init(this);
    QPainter p(this);
    style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this);

    QWidget::paintEvent(event);
}

Both ways to change the background color of QWidget have been successfully built using Qt SDK 1.1 and tested on Symbian devices.