QLayoutItem 类

成员函数文档

[显式] QLayoutItem::QLayoutItem(Qt::Alignment alignment = Qt::Alignment())

使用一个alignment构造布局项。并不是所有子类都支持对齐。

[虚函数 non battled/>\ QLayoutItem::~QLayoutItem()

销毁QLayoutItem。

Qt::Alignment QLayoutItem::alignment() const

返回此项目的对齐方式。

另请参阅setAlignment。

[虚函数] QSizePolicy::ControlTypes QLayoutItem::controlTypes() const

返回布局项的控制类型。对于QWidgetItem，控制类型来自小部件的大小策略；对于QLayoutItem，控制类型是从布局的内容推断出来的。

另请参阅QSizePolicy::controlType。

[纯虚函数] Qt::Orientations QLayoutItem::expandingDirections() const

返回此布局项是否可以比sizeHint()多使用空间。如果值为Qt::Vertical或Qt::Horizontal，则表示它只想在一个维度上增长，而值为Qt::Vertical | Qt::Horizontal表示它想同时在两个维度上增长。

[纯虚函数] QRect QLayoutItem::geometry() const

返回此布局项覆盖的矩形。

另请参阅setGeometry。

[虚函数] bool QLayoutItem::hasHeightForWidth() const

如果此布局的首选高度取决于其宽度，则返回true；否则返回false。默认实现返回false。

在支持“高度与宽度交换”的布局管理器中重新实现此函数。

另请参阅heightForWidth()和QWidget::heightForWidth。

[虚函数] int QLayoutItem::heightForWidth(int) const

给定宽度返回此布局项的首选高度，这里不使用宽度。

默认实现返回 -1，表示首选高度与项目宽度无关。使用函数 hasHeightForWidth() 通常会比调用此函数并测试 -1 快得多。

在支持高度为宽度的布局管理器中重新实现此函数。典型的实现如下所示

int MyLayout::heightForWidth(int w) const
{
    if (cache_dirty || cached_width != w) {
        MyLayout *that = const_cast<MyLayout *>(this);
        int h = calculateHeightForWidth(w);
        that->cached_hfw = h;
        return h;
    }
    return cached_hfw;
}

强烈建议使用缓存；没有它，布局将需要指数级的时间。

另请参阅：hasHeightForWidth()。

[虚函数] void QLayoutItem::invalidate()

使此布局项中的任何缓存的有关信息无效。

[纯虚函数] bool QLayoutItem::isEmpty() const

在子类中实现，返回此项是否为空，即是否包含任何小部件。

[虚函数] QLayout *QLayoutItem::layout()

如果此项目是 QLayout，则将其作为 QLayout 返回；否则返回 nullptr。此函数提供类型安全的转换。

另请参阅：spacerItem() 和 widget()。

[纯虚函数] QSize QLayoutItem::maximumSize() const

在子类中实现，返回此项目的最大尺寸。

[虚函数] int QLayoutItem::minimumHeightForWidth(int w) const

返回给定宽度 w 此小部件所需的最小高度。默认实现简单地返回 heightForWidth(w)。

[纯虚函数] QSize QLayoutItem::minimumSize() const

在子类中实现，返回此项目的最小尺寸。

void QLayoutItem::setAlignment(Qt::Alignment alignment)

将此项目的对齐方式设置为 alignment。

注意： 只有在子类 QLayoutItem 中时，项目对齐才会具有视觉影响。除了提供布局空白空间的 QSpacerItem 之外，所有从 QLayoutItem 继承的公共 Qt 类都支持项目对齐。

另请参阅：alignment()。

[纯虚函数] void QLayoutItem::setGeometry(const QRect &r)

在子类中实现，将此项目的几何形状设置为 r。

另请参阅：geometry()。

[纯虚函数] QSize QLayoutItem::sizeHint() const

在子类中实现，返回此项目的首选尺寸。

[虚拟] QSpacerItem *QLayoutItem::spacerItem()

如果此项目是QSpacerItem，则将其作为QSpacerItem返回；否则返回nullptr。此函数提供类型安全转换。

另请参阅layout()和widget()。

[虚拟] QWidget *QLayoutItem::widget() const

如果此项目管理一个QWidget，则返回该 widgets。否则，返回nullptr。

另请参阅layout()和spacerItem。