[−][src]Struct qt_widgets::QVBoxLayout

#[repr(C)]pub struct QVBoxLayout { /* fields omitted */ }

The QVBoxLayout class lines up widgets vertically.

C++ class: QVBoxLayout.

C++ documentation:

The QVBoxLayout class lines up widgets vertically.

This class is used to construct vertical box layout objects. See QBoxLayout for details.

The simplest use of the class is like this:

      QWidget window = new QWidget;
      QPushButton button1 = new QPushButton("One");
      QPushButton button2 = new QPushButton("Two");
      QPushButton button3 = new QPushButton("Three");
      QPushButton button4 = new QPushButton("Four");
      QPushButton button5 = new QPushButton("Five");
      QVBoxLayout *layout = new QVBoxLayout;
      layout->addWidget(button1);
      layout->addWidget(button2);
      layout->addWidget(button3);
      layout->addWidget(button4);
      layout->addWidget(button5);
      window->setLayout(layout);
      window->show();

First, we create the widgets we want in the layout. Then, we create the QVBoxLayout object and add the widgets into the layout. Finally, we call QWidget::setLayout() to install the QVBoxLayout object onto the widget. At that point, the widgets in the layout are reparented to have window as their parent.

Horizontal box layout with five child widgets

Methods

`impl QVBoxLayout`[src]

`pub unsafe fn meta_object(&self) -> Ptr<QMetaObject>`[src]

Calls C++ function: virtual const QMetaObject* QVBoxLayout::metaObject() const.

`pub unsafe fn new_0a() -> QBox<QVBoxLayout>`[src]

Constructs a new vertical box. You must add it to another layout.

Calls C++ function: [constructor] void QVBoxLayout::QVBoxLayout().

C++ documentation:

Constructs a new vertical box. You must add it to another layout.

`pub unsafe fn new_1a(parent: impl CastInto<Ptr<QWidget>>) -> QBox<QVBoxLayout>`[src]

Constructs a new top-level vertical box with parent parent.

Calls C++ function: [constructor] void QVBoxLayout::QVBoxLayout(QWidget* parent).

C++ documentation:

Constructs a new top-level vertical box with parent parent.

`pub unsafe fn qt_metacall( &self, arg1: Call, arg2: c_int, arg3: mut mut c_void ) -> c_int`[src]

Calls C++ function: virtual int QVBoxLayout::qt_metacall(QMetaObject::Call arg1, int arg2, void** arg3).

`pub unsafe fn qt_metacast(&self, arg1: const c_char) -> mut c_void`[src]

Calls C++ function: virtual void* QVBoxLayout::qt_metacast(const char* arg1).

`pub unsafe fn static_meta_object() -> Ref<QMetaObject>`[src]

Returns a reference to the staticMetaObject field.

`pub unsafe fn tr( s: const c_char, c: const c_char, n: c_int ) -> CppBox<QString>`[src]

Calls C++ function: static QString QVBoxLayout::tr(const char* s, const char* c, int n).

`pub unsafe fn tr_utf8( s: const c_char, c: const c_char, n: c_int ) -> CppBox<QString>`[src]

Calls C++ function: static QString QVBoxLayout::trUtf8(const char* s, const char* c, int n).

Methods from Deref<Target = QBoxLayout>

`pub unsafe fn add_item(&self, arg1: impl CastInto<Ptr<QLayoutItem>>)`[src]

Reimplemented from QLayout::addItem().

Calls C++ function: virtual void QBoxLayout::addItem(QLayoutItem* arg1).

C++ documentation:

Reimplemented from QLayout::addItem().

`pub unsafe fn add_layout_2a( &self, layout: impl CastInto<Ptr<QLayout>>, stretch: c_int )`[src]

Adds layout to the end of the box, with serial stretch factor stretch.

Calls C++ function: void QBoxLayout::addLayout(QLayout* layout, int stretch = …).

C++ documentation:

Adds layout to the end of the box, with serial stretch factor stretch.

See also insertLayout(), addItem(), and addWidget().

`pub unsafe fn add_layout_1a(&self, layout: impl CastInto<Ptr<QLayout>>)`[src]

Adds layout to the end of the box, with serial stretch factor stretch.

Calls C++ function: void QBoxLayout::addLayout(QLayout* layout).

C++ documentation:

Adds layout to the end of the box, with serial stretch factor stretch.

See also insertLayout(), addItem(), and addWidget().

`pub unsafe fn add_spacer_item( &self, spacer_item: impl CastInto<Ptr<QSpacerItem>> )`[src]

Adds spacerItem to the end of this box layout.

Calls C++ function: void QBoxLayout::addSpacerItem(QSpacerItem* spacerItem).

C++ documentation:

Adds spacerItem to the end of this box layout.

This function was introduced in Qt 4.4.

See also addSpacing() and addStretch().

`pub unsafe fn add_spacing(&self, size: c_int)`[src]

Adds a non-stretchable space (a QSpacerItem) with size size to the end of this box layout. QBoxLayout provides default margin and spacing. This function adds additional space.

Calls C++ function: void QBoxLayout::addSpacing(int size).

C++ documentation:

Adds a non-stretchable space (a QSpacerItem) with size size to the end of this box layout. QBoxLayout provides default margin and spacing. This function adds additional space.

See also insertSpacing(), addItem(), and QSpacerItem.

`pub unsafe fn add_stretch_1a(&self, stretch: c_int)`[src]

Adds a stretchable space (a QSpacerItem) with zero minimum size and stretch factor stretch to the end of this box layout.

Calls C++ function: void QBoxLayout::addStretch(int stretch = …).

C++ documentation:

Adds a stretchable space (a QSpacerItem) with zero minimum size and stretch factor stretch to the end of this box layout.

See also insertStretch(), addItem(), and QSpacerItem.

`pub unsafe fn add_stretch_0a(&self)`[src]

Adds a stretchable space (a QSpacerItem) with zero minimum size and stretch factor stretch to the end of this box layout.

Calls C++ function: void QBoxLayout::addStretch().

C++ documentation:

Adds a stretchable space (a QSpacerItem) with zero minimum size and stretch factor stretch to the end of this box layout.

See also insertStretch(), addItem(), and QSpacerItem.

`pub unsafe fn add_strut(&self, arg1: c_int)`[src]

Limits the perpendicular dimension of the box (e.g. height if the box is LeftToRight) to a minimum of size. Other constraints may increase the limit.

Calls C++ function: void QBoxLayout::addStrut(int arg1).

C++ documentation:

Limits the perpendicular dimension of the box (e.g. height if the box is LeftToRight) to a minimum of size. Other constraints may increase the limit.

See also addItem().

`pub unsafe fn add_widget_3a( &self, arg1: impl CastInto<Ptr<QWidget>>, stretch: c_int, alignment: QFlags<AlignmentFlag> )`[src]

Adds widget to the end of this box layout, with a stretch factor of stretch and alignment alignment.

Calls C++ function: void QBoxLayout::addWidget(QWidget* arg1, int stretch = …, QFlags<Qt::AlignmentFlag> alignment = …).

C++ documentation:

Adds widget to the end of this box layout, with a stretch factor of stretch and alignment alignment.

The stretch factor applies only in the direction of the QBoxLayout, and is relative to the other boxes and widgets in this QBoxLayout. Widgets and boxes with higher stretch factors grow more.

If the stretch factor is 0 and nothing else in the QBoxLayout has a stretch factor greater than zero, the space is distributed according to the QWidget:sizePolicy() of each widget that's involved.

The alignment is specified by alignment. The default alignment is 0, which means that the widget fills the entire cell.

See also insertWidget(), addItem(), addLayout(), addStretch(), addSpacing(), and addStrut().

`pub unsafe fn add_widget_2a( &self, arg1: impl CastInto<Ptr<QWidget>>, stretch: c_int )`[src]

Adds widget to the end of this box layout, with a stretch factor of stretch and alignment alignment.

Calls C++ function: void QBoxLayout::addWidget(QWidget* arg1, int stretch = …).

C++ documentation:

Adds widget to the end of this box layout, with a stretch factor of stretch and alignment alignment.

The stretch factor applies only in the direction of the QBoxLayout, and is relative to the other boxes and widgets in this QBoxLayout. Widgets and boxes with higher stretch factors grow more.

If the stretch factor is 0 and nothing else in the QBoxLayout has a stretch factor greater than zero, the space is distributed according to the QWidget:sizePolicy() of each widget that's involved.

The alignment is specified by alignment. The default alignment is 0, which means that the widget fills the entire cell.

See also insertWidget(), addItem(), addLayout(), addStretch(), addSpacing(), and addStrut().

`pub unsafe fn add_widget_1a(&self, arg1: impl CastInto<Ptr<QWidget>>)`[src]

Adds widget to the end of this box layout, with a stretch factor of stretch and alignment alignment.

Calls C++ function: void QBoxLayout::addWidget(QWidget* arg1).

C++ documentation:

Adds widget to the end of this box layout, with a stretch factor of stretch and alignment alignment.

The stretch factor applies only in the direction of the QBoxLayout, and is relative to the other boxes and widgets in this QBoxLayout. Widgets and boxes with higher stretch factors grow more.

If the stretch factor is 0 and nothing else in the QBoxLayout has a stretch factor greater than zero, the space is distributed according to the QWidget:sizePolicy() of each widget that's involved.

The alignment is specified by alignment. The default alignment is 0, which means that the widget fills the entire cell.

See also insertWidget(), addItem(), addLayout(), addStretch(), addSpacing(), and addStrut().

`pub unsafe fn count(&self) -> c_int`[src]

Reimplemented from QLayout::count().

Calls C++ function: virtual int QBoxLayout::count() const.

C++ documentation:

Reimplemented from QLayout::count().

`pub unsafe fn direction(&self) -> Direction`[src]

Returns the direction of the box. addWidget() and addSpacing() work in this direction; the stretch stretches in this direction.

Calls C++ function: QBoxLayout::Direction QBoxLayout::direction() const.

C++ documentation:

Returns the direction of the box. addWidget() and addSpacing() work in this direction; the stretch stretches in this direction.

See also setDirection(), QBoxLayout::Direction, addWidget(), and addSpacing().

`pub unsafe fn expanding_directions(&self) -> QFlags<Orientation>`[src]

Reimplemented from QLayoutItem::expandingDirections().

Calls C++ function: virtual QFlags<Qt::Orientation> QBoxLayout::expandingDirections() const.

C++ documentation:

Reimplemented from QLayoutItem::expandingDirections().

`pub unsafe fn has_height_for_width(&self) -> bool`[src]

Reimplemented from QLayoutItem::hasHeightForWidth().

Calls C++ function: virtual bool QBoxLayout::hasHeightForWidth() const.

C++ documentation:

Reimplemented from QLayoutItem::hasHeightForWidth().

`pub unsafe fn height_for_width(&self, arg1: c_int) -> c_int`[src]

Reimplemented from QLayoutItem::heightForWidth().

Calls C++ function: virtual int QBoxLayout::heightForWidth(int arg1) const.

C++ documentation:

Reimplemented from QLayoutItem::heightForWidth().

`pub unsafe fn insert_item( &self, index: c_int, arg2: impl CastInto<Ptr<QLayoutItem>> )`[src]

Inserts item into this box layout at position index. If index is negative, the item is added at the end.

Calls C++ function: void QBoxLayout::insertItem(int index, QLayoutItem* arg2).

C++ documentation:

Inserts item into this box layout at position index. If index is negative, the item is added at the end.

See also addItem(), insertWidget(), insertLayout(), insertStretch(), and insertSpacing().

`pub unsafe fn insert_layout_3a( &self, index: c_int, layout: impl CastInto<Ptr<QLayout>>, stretch: c_int )`[src]

Inserts layout at position index, with stretch factor stretch. If index is negative, the layout is added at the end.

Calls C++ function: void QBoxLayout::insertLayout(int index, QLayout* layout, int stretch = …).

C++ documentation:

Inserts layout at position index, with stretch factor stretch. If index is negative, the layout is added at the end.

layout becomes a child of the box layout.

See also addLayout() and insertItem().

`pub unsafe fn insert_layout_2a( &self, index: c_int, layout: impl CastInto<Ptr<QLayout>> )`[src]

Inserts layout at position index, with stretch factor stretch. If index is negative, the layout is added at the end.

Calls C++ function: void QBoxLayout::insertLayout(int index, QLayout* layout).

C++ documentation:

Inserts layout at position index, with stretch factor stretch. If index is negative, the layout is added at the end.

layout becomes a child of the box layout.

See also addLayout() and insertItem().

`pub unsafe fn insert_spacer_item( &self, index: c_int, spacer_item: impl CastInto<Ptr<QSpacerItem>> )`[src]

Inserts spacerItem at position index, with zero minimum size and stretch factor. If index is negative the space is added at the end.

Calls C++ function: void QBoxLayout::insertSpacerItem(int index, QSpacerItem* spacerItem).

C++ documentation:

Inserts spacerItem at position index, with zero minimum size and stretch factor. If index is negative the space is added at the end.

This function was introduced in Qt 4.4.

See also addSpacerItem(), insertStretch(), and insertSpacing().

`pub unsafe fn insert_spacing(&self, index: c_int, size: c_int)`[src]

Inserts a non-stretchable space (a QSpacerItem) at position index, with size size. If index is negative the space is added at the end.

Calls C++ function: void QBoxLayout::insertSpacing(int index, int size).

C++ documentation:

Inserts a non-stretchable space (a QSpacerItem) at position index, with size size. If index is negative the space is added at the end.

The box layout has default margin and spacing. This function adds additional space.

See also addSpacing(), insertItem(), and QSpacerItem.

`pub unsafe fn insert_stretch_2a(&self, index: c_int, stretch: c_int)`[src]

Inserts a stretchable space (a QSpacerItem) at position index, with zero minimum size and stretch factor stretch. If index is negative the space is added at the end.

Calls C++ function: void QBoxLayout::insertStretch(int index, int stretch = …).

C++ documentation:

Inserts a stretchable space (a QSpacerItem) at position index, with zero minimum size and stretch factor stretch. If index is negative the space is added at the end.

See also addStretch(), insertItem(), and QSpacerItem.

`pub unsafe fn insert_stretch_1a(&self, index: c_int)`[src]

Inserts a stretchable space (a QSpacerItem) at position index, with zero minimum size and stretch factor stretch. If index is negative the space is added at the end.

Calls C++ function: void QBoxLayout::insertStretch(int index).

C++ documentation:

Inserts a stretchable space (a QSpacerItem) at position index, with zero minimum size and stretch factor stretch. If index is negative the space is added at the end.

See also addStretch(), insertItem(), and QSpacerItem.

`pub unsafe fn insert_widget_4a( &self, index: c_int, widget: impl CastInto<Ptr<QWidget>>, stretch: c_int, alignment: QFlags<AlignmentFlag> )`[src]

Inserts widget at position index, with stretch factor stretch and alignment alignment. If index is negative, the widget is added at the end.

Calls C++ function: void QBoxLayout::insertWidget(int index, QWidget* widget, int stretch = …, QFlags<Qt::AlignmentFlag> alignment = …).

C++ documentation:

Inserts widget at position index, with stretch factor stretch and alignment alignment. If index is negative, the widget is added at the end.

The stretch factor applies only in the direction of the QBoxLayout, and is relative to the other boxes and widgets in this QBoxLayout. Widgets and boxes with higher stretch factors grow more.

If the stretch factor is 0 and nothing else in the QBoxLayout has a stretch factor greater than zero, the space is distributed according to the QWidget:sizePolicy() of each widget that's involved.

The alignment is specified by alignment. The default alignment is 0, which means that the widget fills the entire cell.

See also addWidget() and insertItem().

`pub unsafe fn insert_widget_3a( &self, index: c_int, widget: impl CastInto<Ptr<QWidget>>, stretch: c_int )`[src]

Inserts widget at position index, with stretch factor stretch and alignment alignment. If index is negative, the widget is added at the end.

Calls C++ function: void QBoxLayout::insertWidget(int index, QWidget* widget, int stretch = …).

C++ documentation:

Inserts widget at position index, with stretch factor stretch and alignment alignment. If index is negative, the widget is added at the end.

The stretch factor applies only in the direction of the QBoxLayout, and is relative to the other boxes and widgets in this QBoxLayout. Widgets and boxes with higher stretch factors grow more.

If the stretch factor is 0 and nothing else in the QBoxLayout has a stretch factor greater than zero, the space is distributed according to the QWidget:sizePolicy() of each widget that's involved.

The alignment is specified by alignment. The default alignment is 0, which means that the widget fills the entire cell.

See also addWidget() and insertItem().

`pub unsafe fn insert_widget_2a( &self, index: c_int, widget: impl CastInto<Ptr<QWidget>> )`[src]

Inserts widget at position index, with stretch factor stretch and alignment alignment. If index is negative, the widget is added at the end.

Calls C++ function: void QBoxLayout::insertWidget(int index, QWidget* widget).

C++ documentation:

Inserts widget at position index, with stretch factor stretch and alignment alignment. If index is negative, the widget is added at the end.

The stretch factor applies only in the direction of the QBoxLayout, and is relative to the other boxes and widgets in this QBoxLayout. Widgets and boxes with higher stretch factors grow more.

If the stretch factor is 0 and nothing else in the QBoxLayout has a stretch factor greater than zero, the space is distributed according to the QWidget:sizePolicy() of each widget that's involved.

The alignment is specified by alignment. The default alignment is 0, which means that the widget fills the entire cell.

See also addWidget() and insertItem().

`pub unsafe fn invalidate(&self)`[src]

Reimplemented from QLayoutItem::invalidate().

Calls C++ function: virtual void QBoxLayout::invalidate().

C++ documentation:

Reimplemented from QLayoutItem::invalidate().

Resets cached information.

`pub unsafe fn item_at(&self, arg1: c_int) -> Ptr<QLayoutItem>`[src]

Reimplemented from QLayout::itemAt().

Calls C++ function: virtual QLayoutItem* QBoxLayout::itemAt(int arg1) const.

C++ documentation:

Reimplemented from QLayout::itemAt().

`pub unsafe fn maximum_size(&self) -> CppBox<QSize>`[src]

Reimplemented from QLayoutItem::maximumSize().

Calls C++ function: virtual QSize QBoxLayout::maximumSize() const.

C++ documentation:

Reimplemented from QLayoutItem::maximumSize().

`pub unsafe fn meta_object(&self) -> Ptr<QMetaObject>`[src]

Calls C++ function: virtual const QMetaObject* QBoxLayout::metaObject() const.

`pub unsafe fn minimum_height_for_width(&self, arg1: c_int) -> c_int`[src]

Reimplemented from QLayoutItem::minimumHeightForWidth().

Calls C++ function: virtual int QBoxLayout::minimumHeightForWidth(int arg1) const.

C++ documentation:

Reimplemented from QLayoutItem::minimumHeightForWidth().

`pub unsafe fn minimum_size(&self) -> CppBox<QSize>`[src]

Reimplemented from QLayoutItem::minimumSize().

Calls C++ function: virtual QSize QBoxLayout::minimumSize() const.

C++ documentation:

Reimplemented from QLayoutItem::minimumSize().

`pub unsafe fn qt_metacall( &self, arg1: Call, arg2: c_int, arg3: mut mut c_void ) -> c_int`[src]

Calls C++ function: virtual int QBoxLayout::qt_metacall(QMetaObject::Call arg1, int arg2, void** arg3).

`pub unsafe fn qt_metacast(&self, arg1: const c_char) -> mut c_void`[src]

Calls C++ function: virtual void* QBoxLayout::qt_metacast(const char* arg1).

`pub unsafe fn set_direction(&self, arg1: Direction)`[src]

Sets the direction of this layout to direction.

Calls C++ function: void QBoxLayout::setDirection(QBoxLayout::Direction arg1).

C++ documentation:

Sets the direction of this layout to direction.

See also direction().

`pub unsafe fn set_geometry(&self, arg1: impl CastInto<Ref<QRect>>)`[src]

Reimplemented from QLayoutItem::setGeometry().

Calls C++ function: virtual void QBoxLayout::setGeometry(const QRect& arg1).

C++ documentation:

Reimplemented from QLayoutItem::setGeometry().

`pub unsafe fn set_spacing(&self, spacing: c_int)`[src]

Reimplements QLayout::setSpacing(). Sets the spacing property to spacing.

Calls C++ function: void QBoxLayout::setSpacing(int spacing).

C++ documentation:

Reimplements QLayout::setSpacing(). Sets the spacing property to spacing.

See also QLayout::setSpacing() and spacing().

`pub unsafe fn set_stretch(&self, index: c_int, stretch: c_int)`[src]

Sets the stretch factor at position index. to stretch.

Calls C++ function: void QBoxLayout::setStretch(int index, int stretch).

C++ documentation:

Sets the stretch factor at position index. to stretch.

This function was introduced in Qt 4.5.

See also stretch().

`pub unsafe fn set_stretch_factor_q_widget_int( &self, w: impl CastInto<Ptr<QWidget>>, stretch: c_int ) -> bool`[src]

Sets the stretch factor for widget to stretch and returns true if widget is found in this layout (not including child layouts); otherwise returns false.

Calls C++ function: bool QBoxLayout::setStretchFactor(QWidget* w, int stretch).

C++ documentation:

Sets the stretch factor for widget to stretch and returns true if widget is found in this layout (not including child layouts); otherwise returns false.

See also setAlignment().

`pub unsafe fn set_stretch_factor_q_layout_int( &self, l: impl CastInto<Ptr<QLayout>>, stretch: c_int ) -> bool`[src]

This is an overloaded function.

Calls C++ function: bool QBoxLayout::setStretchFactor(QLayout* l, int stretch).

C++ documentation:

This is an overloaded function.

Sets the stretch factor for the layout layout to stretch and returns true if layout is found in this layout (not including child layouts); otherwise returns false.

`pub unsafe fn size_hint(&self) -> CppBox<QSize>`[src]

Reimplemented from QLayoutItem::sizeHint().

Calls C++ function: virtual QSize QBoxLayout::sizeHint() const.

C++ documentation:

Reimplemented from QLayoutItem::sizeHint().

`pub unsafe fn spacing(&self) -> c_int`[src]

Reimplements QLayout::spacing(). If the spacing property is valid, that value is returned. Otherwise, a value for the spacing property is computed and returned. Since layout spacing in a widget is style dependent, if the parent is a widget, it queries the style for the (horizontal or vertical) spacing of the layout. Otherwise, the parent is a layout, and it queries the parent layout for the spacing().

Calls C++ function: int QBoxLayout::spacing() const.

C++ documentation:

Reimplements QLayout::spacing(). If the spacing property is valid, that value is returned. Otherwise, a value for the spacing property is computed and returned. Since layout spacing in a widget is style dependent, if the parent is a widget, it queries the style for the (horizontal or vertical) spacing of the layout. Otherwise, the parent is a layout, and it queries the parent layout for the spacing().

See also QLayout::spacing() and setSpacing().