Contents

KColumnResizer Class

Maintains consistent column sizes across layouts. More...

Header: #include <KColumnResizer>
CMake: find_package(KF6 REQUIRED COMPONENTS WidgetsAddons)
target_link_libraries(mytarget PRIVATE KF6::WidgetsAddons)
Since: 5.1
Inherits: QObject

Public Functions

KColumnResizer(QObject *parent = nullptr)
void addWidget(QWidget *widget)
void addWidgetsFromLayout(QLayout *layout, int column = 0)
void removeWidget(QWidget *widget)

Detailed Description

KColumnResizer is a helper class which can force columns of different layouts to keep the same width. It is useful to keep label columns consistent.

It works with QGridLayout and QFormLayout.

"left: without KColumnResizer - right: with KColumnResizer"

Here is a typical example:

void Window::createWidgets()
{
    QVBoxLayout *layout = new QVBoxLayout(this);

    QGroupBox *box1 = new QGroupBox();
    // Fill box1
    // ...
    layout->addWidget(box1);

    QGroupBox *box2 = new QGroupBox();
    // Fill box2
    // ...
    layout->addWidget(box2);

    KColumnResizer *resizer = new KColumnResizer(this);
    resizer->addWidgetsFromLayout(box1->layout(), 0);
    resizer->addWidgetsFromLayout(box2->layout(), 0);
}

In this example box1 and box2 children can be organized using QGridLayout or QFormLayout, resizer will ensure the first columns of the two QGroupBox stay the same width.

Member Function Documentation

[explicit] KColumnResizer::KColumnResizer(QObject *parent = nullptr)

Constructs a KColumnResizer.

void KColumnResizer::addWidget(QWidget *widget)

Add a single widget to the list of widgets whose width is monitored.

It is more common to use addWidgetsFromLayout(), but adding single widgets can be useful if you want to keep a single button the same width as a column in a layout.

widget The widget to add

void KColumnResizer::addWidgetsFromLayout(QLayout *layout, int column = 0)

Add all widgets from layout which are in column column to the list of widgets to manage.

layout The layout containing the widgets to add. KColumnResizer supports QGridLayout and QFormLayout.

column The column number which contains the widgets. If layout is a QFormLayout, column should not be higher than QFormLayout::SpanningRole

void KColumnResizer::removeWidget(QWidget *widget)

Remove a widget previously added by addWidget or addWidgetsFromLayout.

widget The widget to remove