Класс QLayoutItem

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

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

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

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

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

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

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

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

У некоторых макетов существуют взаимозависимости ширины и высоты. Их можно выразить с помощью hasHeightForWidth(), heightForWidth() и minimumHeightForWidth(). Более подробная информация приведена в статье Qt Quarterly Trading Height for Width.

См. также QLayout.

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

QLayoutItem::QLayoutItem(Qt::Alignment alignment = Qt::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

Реализуется в подклассах для возвращения значения 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()

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

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

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