KoVBox Class Reference

#include <KoVBox.h>

Inheritance diagram for KoVBox:

Public Member Functions
	KoVBox (QWidget *parent=0)
QSize	minimumSizeHint () const override
void	setMargin (int margin)
void	setSpacing (int space)
void	setStretchFactor (QWidget *widget, int stretch)
QSize	sizeHint () const override
	~KoVBox () override

Protected Member Functions
void	childEvent (QChildEvent *ev) override

Private Attributes
Private *const	d

Friends
class	Private

Detailed Description

A container widget which arranges its children vertically.

When using a KoVBox you don't need to create a layout nor to add the child widgets to it.

Both margin and spacing are initialized to 0. Use QHBoxLayout if you need standard layout margins.

See also

KVBox

Definition at line 27 of file KoVBox.h.

Constructor & Destructor Documentation

KoVBox()

KoVBox::KoVBox ( QWidget * parent = 0 )

explicit

Creates a new hbox.

Definition at line 13 of file KoVBox.cpp.

    : QFrame(parent),
      d(0)
{
    QVBoxLayout *layout = new QVBoxLayout(this);
    layout->setSpacing(0);
    layout->setContentsMargins(0, 0, 0, 0);
}

~KoVBox()

KoVBox::~KoVBox ( )

override

Destructor.

Definition at line 22 of file KoVBox.cpp.

{
}

Member Function Documentation

childEvent()

void KoVBox::childEvent ( QChildEvent * ev )

overrideprotected

Definition at line 26 of file KoVBox.cpp.

{
    switch (event->type()) {
    case QEvent::ChildAdded: {
        QChildEvent *childEvent = static_cast<QChildEvent *>(event);
        if (childEvent->child()->isWidgetType()) {
            QWidget *widget = static_cast<QWidget *>(childEvent->child());
            static_cast<QBoxLayout *>(layout())->addWidget(widget);
        }
 
        break;
    }
    case QEvent::ChildRemoved: {
        QChildEvent *childEvent = static_cast<QChildEvent *>(event);
        if (childEvent->child()->isWidgetType()) {
            QWidget *widget = static_cast<QWidget *>(childEvent->child());
            static_cast<QBoxLayout *>(layout())->removeWidget(widget);
        }
 
        break;
    }
    default:
        break;
    }
    QFrame::childEvent(event);
}

References childEvent().

minimumSizeHint()

QSize KoVBox::minimumSizeHint ( ) const

override

Calculate the recommended minimum size for this hbox.

Definition at line 61 of file KoVBox.cpp.

{
    KoVBox *that = const_cast<KoVBox *>(this);
    QApplication::sendPostedEvents(that, QEvent::ChildAdded);
 
    return QFrame::minimumSizeHint();
}

setMargin()

void KoVBox::setMargin

(

int

margin

)

Sets the margin of the hbox.

Definition at line 79 of file KoVBox.cpp.

{
    layout()->setContentsMargins(margin, margin, margin, margin);
}

setSpacing()

void KoVBox::setSpacing

(

int

space

)

Sets the spacing between the child widgets to space.

To get the default layout spacing, set space to -1.

Definition at line 69 of file KoVBox.cpp.

{
    layout()->setSpacing(spacing);
}

setStretchFactor()

void KoVBox::setStretchFactor	(	QWidget *	widget,
		int	stretch )

Sets the stretch factor of widget to stretch.

Definition at line 74 of file KoVBox.cpp.

{
    static_cast<QBoxLayout *>(layout())->setStretchFactor(widget, stretch);
}

References setStretchFactor().

sizeHint()

QSize KoVBox::sizeHint ( ) const

override

Calculate the recommended size for this hbox.

Definition at line 53 of file KoVBox.cpp.

{
    KoVBox *that = const_cast<KoVBox *>(this);
    QApplication::sendPostedEvents(that, QEvent::ChildAdded);
 
    return QFrame::sizeHint();
}

Friends And Related Symbol Documentation

Private

friend class Private

friend

Definition at line 75 of file KoVBox.h.

Member Data Documentation

d

Private* const KoVBox::d

private

Definition at line 76 of file KoVBox.h.

---

The documentation for this class was generated from the following files:

• libs/widgets/KoVBox.h
• libs/widgets/KoVBox.cpp