Класс QGraphicsAnchorLayout

Класс QGraphicsAnchorLayout предоставляет макет, где можно привязать виджеты друг к другу в представлении Graphics View. Подробнее...

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

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

Переопределённые открытые функции

Переопределённые защищённые функции

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

Макет anchor позволяет разработчикам указать, как следует размещать виджеты относительно друг друга и самого макета. Указание делается путём добавления якорей в макет, вызывая addAnchor(), addAnchors() или addCornerAnchors().

Существующие якоря в макете можно получить с помощью функции anchor(). Элементы, к которым прикреплены якоря, автоматически добавляются в макет, а если элементы удаляются, все их якоря автоматически удаляются.

Якоря всегда устанавливаются между краями элемента, где «центр» также считается краем. Рассмотрим следующий пример:

layout->addAnchor(b, Qt::AnchorLeft, a, Qt::AnchorRight);
layout->addAnchor(b, Qt::AnchorTop, a, Qt::AnchorBottom);

Здесь правый край элемента a привязан к левому краю элемента b, а нижний край элемента a привязан к верхнему краю элемента b, в результате чего элемент b будет размещён диагонально справа и ниже элемента b.

Функция addCornerAnchors() предоставляет более простой способ привязки углов двух виджетов, чем два отдельных вызова addAnchor(), показанные в коде выше. Здесь показано, как виджет можно привязать к верхнему левому углу окружающего макета:

layout->addCornerAnchors(a, Qt::TopLeftCorner, layout, Qt::TopLeftCorner);

В случаях, когда якоря используются для соответствия ширины или высоты виджетов, удобно использовать функцию addAnchors(). Как и в других функциях для задания якорей, её также можно использовать для привязки виджета к макету.

Подсказки размера и политики размера в макете Anchor

QGraphicsAnchorLayout учитывает подсказки размера и политики размера каждого элемента. Обратите внимание, что некоторые свойства QSizePolicy не учитываются.

Интервалы в макете Anchor

Макет может распределять некоторое пространство между элементами. Если отступ не указан явно, фактическая величина отступа обычно равна 0.

Однако, если первый край является противоположным второму краю (например, правый край первого виджета привязан к левому краю второго виджета), размер якоря будет запрошен у стиля через метрику пикселей: PM_LayoutHorizontalSpacing для горизонтальных якорей и PM_LayoutVerticalSpacing для вертикальных якорей.

Если отступ отрицательный, элементы частично перекрываются.

Известные проблемы

Существуют некоторые функции, которые QGraphicsAnchorLayout в настоящее время не поддерживает. Это может измениться в будущем, поэтому избегайте использования этих функций, если вы хотите избежать возможных будущих регрессий в поведении:

• Коэффициенты растяжения не учитываются.
• QSizePolicy::ExpandFlag не учитывается.
• Высота по ширине не учитывается.

См. также QGraphicsLinearLayout, QGraphicsGridLayout и QGraphicsLayout.

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

QGraphicsAnchorLayout::QGraphicsAnchorLayout(QGraphicsLayoutItem *parent = nullptr)

Создаёт экземпляр QGraphicsAnchorLayout. parent передаётся конструктору QGraphicsLayout.

[virtual] QGraphicsAnchorLayout::~QGraphicsAnchorLayout()

Удаляет объект QGraphicsAnchorLayout.

QGraphicsAnchor *QGraphicsAnchorLayout::addAnchor(QGraphicsLayoutItem *firstItem, Qt::AnchorPoint firstEdge, QGraphicsLayoutItem *secondItem, Qt::AnchorPoint secondEdge)

Создаёт якорь между краем firstEdge элемента firstItem и краем secondEdge элемента secondItem. Отступ якоря выбирается из стиля. Якоря между краем макета и краем элемента имеют размер 0. Если между краями уже есть якорь, новый якорь заменит старый.

firstItem и secondItem автоматически добавляются в макет, если они не являются частью макета. Это означает, что count() может увеличиться на 2.

Отступ, который получит якорь, зависит от типа якоря. Например, якоря от правого края одного элемента до левого края другого (или наоборот) будут использовать стандартный горизонтальный отступ. То же самое поведение применимо к якорям снизу вверх (но они будут использовать стандартный вертикальный отступ). Для всех других комбинаций якорей отступ будет равен 0. Все функции привязки будут следовать этому правилу.

Отступ также можно установить вручную, используя метод QGraphicsAnchor::setSpacing().

Вызов этой функции, где firstItem или secondItem являются предками макета, имеет неопределённое поведение.

См. также addAnchors() и addCornerAnchors().

void QGraphicsAnchorLayout::addAnchors(QGraphicsLayoutItem *firstItem, QGraphicsLayoutItem *secondItem, Qt::Orientations orientations = Qt::Horizontal | Qt::Vertical)

Привязывает два или четыре края firstItem к соответствующим краям secondItem, чтобы firstItem имел тот же размер, что и secondItem, по измерениям, заданным orientations.

Например, следующий пример привязывает левые и правые края двух элементов, чтобы они соответствовали их ширинам:

layout->addAnchor(b, Qt::AnchorLeft, c, Qt::AnchorLeft);
layout->addAnchor(b, Qt::AnchorRight, c, Qt::AnchorRight);

Это также можно сделать с помощью следующей строки кода:

layout->addAnchors(b, c, Qt::Horizontal);

См. также addAnchor() и addCornerAnchors().

void QGraphicsAnchorLayout::addCornerAnchors(QGraphicsLayoutItem *firstItem, Qt::Corner firstCorner, QGraphicsLayoutItem *secondItem, Qt::Corner secondCorner)

Создаёт две привязки между firstItem и secondItem, определяемые углами firstCorner и secondCorner, где одна используется для горизонтального края, а другая — для вертикального.

Это вспомогательная функция, так как привязку углов можно выразить как привязку двух краёв. Например:

layout->addAnchor(a, Qt::AnchorTop, layout, Qt::AnchorTop);
layout->addAnchor(a, Qt::AnchorLeft, layout, Qt::AnchorLeft);

Это также можно сделать с помощью следующей строки кода:

layout->addCornerAnchors(a, Qt::TopLeftCorner, layout, Qt::TopLeftCorner);

Если между парами краёв уже существует привязка, она будет заменена привязками, указанными этой функцией.

firstItem и secondItem автоматически добавляются в макет, если они не являются частью макета. Это означает, что count() может увеличиться максимум на 2.

См. также addAnchor() и addAnchors().

QGraphicsAnchor *QGraphicsAnchorLayout::anchor(QGraphicsLayoutItem *firstItem, Qt::AnchorPoint firstEdge, QGraphicsLayoutItem *secondItem, Qt::AnchorPoint secondEdge)

Возвращает привязку между точками привязки, определёнными firstItem и firstEdge, и secondItem и secondEdge. Если такой привязки нет, функция вернёт 0.

[override virtual] int QGraphicsAnchorLayout::count() const

Переопределяет: QGraphicsLayout::count() const.

qreal QGraphicsAnchorLayout::horizontalSpacing() const

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

См. также verticalSpacing() и setHorizontalSpacing().

[override virtual] void QGraphicsAnchorLayout::invalidate()

Переопределяет: QGraphicsLayout::invalidate().

[override virtual] QGraphicsLayoutItem *QGraphicsAnchorLayout::itemAt(int index) const

Переопределяет: QGraphicsLayout::itemAt(int i) const.

[override virtual] void QGraphicsAnchorLayout::removeAt(int index)

Переопределяет: QGraphicsLayout::removeAt(int index).

Удаляет элемент макета по индексу index, не уничтожая его. Владение элементом передаётся вызывающему коду.

Удаление элемента также удалит любые связанные с ним привязки.

См. также itemAt() и count().

[override virtual] void QGraphicsAnchorLayout::setGeometry(const QRectF &geom)

Переопределяет: QGraphicsLayoutItem::setGeometry(const QRectF &rect).

void QGraphicsAnchorLayout::setHorizontalSpacing(qreal spacing)

Устанавливает стандартное горизонтальное расстояние для макета привязки в значение spacing.

См. также horizontalSpacing(), setVerticalSpacing() и setSpacing().

void QGraphicsAnchorLayout::setSpacing(qreal spacing)

Устанавливает стандартное горизонтальное и вертикальное расстояние для макета привязки в значение spacing.

Если элемент привязан без расстояния, связанного с привязкой, он будет использовать стандартное расстояние.

QGraphicsAnchorLayout не поддерживает отрицательные расстояния. Установка отрицательного значения сбросит предыдущее расстояние и заставит макет использовать расстояние, предоставленное текущей стилистикой виджета.

См. также setHorizontalSpacing() и setVerticalSpacing().

void QGraphicsAnchorLayout::setVerticalSpacing(qreal spacing)

Устанавливает стандартное вертикальное расстояние для макета привязки в значение spacing.

См. также verticalSpacing(), setHorizontalSpacing() и setSpacing().

[override virtual protected] QSizeF QGraphicsAnchorLayout::sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const

Переопределяет: QGraphicsLayoutItem::sizeHint(Qt::SizeHint which, const QSizeF &constraint) const.

qreal QGraphicsAnchorLayout::verticalSpacing() const

Возвращает стандартное вертикальное расстояние для макета привязки.

См. также horizontalSpacing() и setVerticalSpacing().