Класс QLayoutItem

Класс QLayoutItem предоставляет абстрактный элемент, который обрабатывает QLayout. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Подробное описание

Используется пользовательскими макетами.

Предоставлены чистые виртуальные функции для получения информации о макете, включая sizeHint(), minimumSize(), maximumSize() и expanding().

Геометрию макета можно задать и получить с помощью setGeometry() и geometry(), а выравнивание — с помощью setAlignment() и alignment().

isEmpty() возвращает значение true, если элемент макета пустой; иначе — false. Если конкретный элемент — QWidget, он может быть получен с помощью widget(). Аналогично для layout() и spacerItem().

В некоторых макетах существуют зависимости между шириной и высотой. Их можно выразить с помощью hasHeightForWidth(), heightForWidth() и minimumHeightForWidth(). Более подробное объяснение см. в статье Qt Quarterly Торговля высотой за ширину.

См. также QLayout.

Документация по функциям-членам

QLayoutItem::QLayoutItem(Qt::Alignment alignment = Qt::Alignment())

Создаёт элемент макета с выравниванием. Не все подклассы поддерживают выравнивание.

[virtual] QLayoutItem::~QLayoutItem()

Удаляет QLayoutItem.

Qt::Alignment QLayoutItem::alignment() const

Возвращает выравнивание этого элемента.

См. также setAlignment().

[virtual] QSizePolicy::ControlTypes QLayoutItem::controlTypes() const

Возвращает тип(ы) управления для элемента макета. Для QWidgetItem тип управления берётся из политики размера виджета; для QLayoutItem типы управления выводятся из содержимого макета.

См. также QSizePolicy::controlType().

[pure virtual] Qt::Orientations QLayoutItem::expandingDirections() const

Возвращает, может ли этот элемент макета использовать больше места, чем sizeHint(). Значение Qt::Vertical или Qt::Horizontal означает, что он хочет расти только в одном измерении, тогда как Qt::Vertical | Qt::Horizontal означает, что он хочет расти в обоих измерениях.

[pure virtual] QRect QLayoutItem::geometry() const

Возвращает прямоугольник, занимаемый этим элементом макета.

См. также setGeometry().

[virtual] bool QLayoutItem::hasHeightForWidth() const

Возвращает true если предпочтительная высота этого макета зависит от его ширины; в противном случае возвращает false. По умолчанию возвращает false.

Переопределите эту функцию в менеджерах макетов, которые поддерживают высоту для ширины.

См. также heightForWidth() и QWidget::heightForWidth().

[virtual] 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().

[virtual] void QLayoutItem::invalidate()

Очищает кэшированную информацию в этом элементе макета.

[pure virtual] bool QLayoutItem::isEmpty() const

Реализовано в подклассах для возвращения значения true, если этот элемент пустой, т.е. не содержит каких-либо виджетов.

[virtual] QLayout *QLayoutItem::layout()

Если этот элемент является QLayout, он возвращается как QLayout; в противном случае возвращается nullptr. Эта функция обеспечивает безопасный по типу вывод.

См. также spacerItem() и widget().

[pure virtual] QSize QLayoutItem::maximumSize() const

Реализовано в подклассах для возвращения максимального размера этого элемента.

[virtual] int QLayoutItem::minimumHeightForWidth(int w) const

Возвращает минимальную высоту, необходимую этому виджету для заданной ширины w. Реализация по умолчанию просто возвращает heightForWidth(w).

[pure virtual] QSize QLayoutItem::minimumSize() const

Реализовано в подклассах для возвращения минимального размера этого элемента.

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

Устанавливает выравнивание этого элемента по alignment.

Примечание: Выравнивание элементов поддерживается только подклассами QLayoutItem, где это оказывает визуальное влияние. За исключением QSpacerItem, который предоставляет пустое место для макетов, все общедоступные классы Qt, наследующие от QLayoutItem, поддерживают выравнивание элементов.

См. также alignment().

[pure virtual] void QLayoutItem::setGeometry(const QRect &r)

Реализовано в подклассах для установки геометрии этого элемента на r.

См. также geometry().

[pure virtual] QSize QLayoutItem::sizeHint() const

Реализовано в подклассах для возвращения предпочтительного размера этого элемента.

[virtual] QSpacerItem *QLayoutItem::spacerItem()

Если этот элемент является QSpacerItem, он возвращается как QSpacerItem; в противном случае nullptr возвращается. Эта функция обеспечивает безопасный по типу приведение типов.

См. также layout() и widget().

[virtual] QWidget *QLayoutItem::widget() const

Если этот элемент управляет QWidget, возвращает этот виджет. В противном случае nullptr возвращается.

См. также layout() и spacerItem().