This example shows several different frame styles which can be added to a variety of GUI widgets. A frame can also be used to group a collection of related widgets. The purpose of using a frame is to change the visual appearance of the border around a single widget or a group of widgets.<\/p>\n\n\n
\n#include <QtCore>\n#include <QtGui>\n\nclass MainWindow : public QWidget\n{\n public:\n MainWindow(); \n};\n<\/pre><\/div>\n\n\nThe class for MainWindow simply declares a constructor.<\/p>\n\n\n
\nMainWindow::MainWindow()\n{\n setMinimumSize(500, 600);\n\n QLabel *label = new QLabel();\n label->setText("Label with a Frame");\n label->setAlignment(Qt::AlignHCenter | Qt::AlignVCenter);\n label->setFrameStyle(QFrame::Panel | QFrame::Raised);\n label->setLineWidth(3);\n label->setMinimumSize(25, 30);\n\n auto *frame1 = new QFrame();\n frame1->setFrameStyle(QFrame::Box);\n frame1->setLineWidth(3);\n frame1->setMidLineWidth(2);\n frame1->setMinimumSize(25, 30);\n\n auto *frame2 = new QFrame(this);\n frame2->setFrameStyle(QFrame::Box | QFrame::Raised);\n frame2->setLineWidth(3);\n frame2->setMidLineWidth(2);\n frame2->setMinimumSize(25, 30);\n\n auto *frame3 = new QFrame(this);\n frame3->setFrameStyle(QFrame::Box | QFrame::Sunken);\n frame3->setLineWidth(3);\n frame3->setMidLineWidth(2);\n frame3->setMinimumSize(25, 30);\n\n QPushButton *pb_close = new QPushButton();\n pb_close->setText("Close");\n\n QGridLayout *grid = new QGridLayout();\n grid->setVerticalSpacing(20);\n\n grid->addWidget(label);\n grid->addWidget(frame1);\n grid->addWidget(frame2);\n grid->addWidget(frame3);\n\n QHBoxLayout *layout = new QHBoxLayout();\n layout->addStretch();\n layout->addWidget(pb_close);\n layout->addStretch();\n\n QVBoxLayout *layout_main = new QVBoxLayout(this);\n layout_main->addLayout(grid);\n layout_main->addSpacing(25);\n layout_main->addLayout(layout);\n\n connect(pb_close, &QPushButton::clicked, \n this, &QWidget::close);\n}\n<\/pre><\/div>\n\n\nA frame can be drawn around widgets like a QLabel or QTextEdit. Both of these widgets inherit from the QFrame class so adding a frame simply involves calling a few methods from the QFrame class. <\/p>\n\n\n\n
A frame is defined by calling <\/strong>setFrameStyle() and passing enum values to set the frame shape<\/strong><\/span> and the frame Shadow<\/span><\/strong>. The shape and shadow can also be set independently calling setFrameShape() and setFrameShadow().<\/p>\n\n\n\nOn line 5 a new QLabel widget is created and then on line 8 the frame shape is set to Panel and the frame shadow is set to Raised. The call to setLineWidth() on line 9 defines the thickness of the frame style.<\/p>\n\n\n\n
On lines 12, 18, and 24 three different frames are declared to show various other combinations. All three of these use a frame shape of Box. The frame shadows are Plain (which is the default), Raised, and Sunken. <\/p>\n\n\n\n
The label and three frame widgets are added to a Grid. The grid and the close push button are then added to a vertical layout. <\/p>\n\n\n\n
Main Function<\/h3>\n\n\n\n
Since the source code for main() has not changed there is no need to show it again. Refer to example 3 or download the full source for this example.<\/p>\n\n\n\n
Running the Example<\/h3>\n\n\n\n
To build and run this example use the same CMake build file and commands as we showed for the first example. The only suggested modification is on line 2 of the CMakeLists.txt file, change “example_1” to “example_21”. <\/p>\n\n\n\n