Класс QLayoutItem

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

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

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

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

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

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

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

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

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

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

См. также QLayout.

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

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

Создаёт элемент макета с выравниванием 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) {
        // not all C++ compilers support "mutable"
        MyLayout *that = (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

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

[virtual] QLayout *QLayoutItem::layout()

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

См. также 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; в противном случае возвращается 0. Эта функция обеспечивает безопасный по типу ввод.

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

[virtual] QWidget *QLayoutItem::widget()

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

Примечание: Хотя функции layout() и spacerItem() выполняют преобразования, эта функция возвращает другой объект: QLayout и QSpacerItem наследуют QLayoutItem, а QWidget — нет.

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