QGraphicsAnchorLayout Class
La clase QGraphicsAnchorLayout ofrece un diseño que permite anclar widgets entre sí en Graphics View. Más información...
| Encabezado: | #include <QGraphicsAnchorLayout> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredan: | QGraphicsLayout |
Funciones públicas
| QGraphicsAnchorLayout(QGraphicsLayoutItem *parent = nullptr) | |
| virtual | ~QGraphicsAnchorLayout() |
| QGraphicsAnchor * | addAnchor(QGraphicsLayoutItem *firstItem, Qt::AnchorPoint firstEdge, QGraphicsLayoutItem *secondItem, Qt::AnchorPoint secondEdge) |
| void | addAnchors(QGraphicsLayoutItem *firstItem, QGraphicsLayoutItem *secondItem, Qt::Orientations orientations = Qt::Horizontal | Qt::Vertical) |
| void | addCornerAnchors(QGraphicsLayoutItem *firstItem, Qt::Corner firstCorner, QGraphicsLayoutItem *secondItem, Qt::Corner secondCorner) |
| QGraphicsAnchor * | anchor(QGraphicsLayoutItem *firstItem, Qt::AnchorPoint firstEdge, QGraphicsLayoutItem *secondItem, Qt::AnchorPoint secondEdge) |
| qreal | horizontalSpacing() const |
| void | setHorizontalSpacing(qreal spacing) |
| void | setSpacing(qreal spacing) |
| void | setVerticalSpacing(qreal spacing) |
| qreal | verticalSpacing() const |
Funciones públicas reimplementadas
| virtual int | count() const override |
| virtual void | invalidate() override |
| virtual QGraphicsLayoutItem * | itemAt(int index) const override |
| virtual void | removeAt(int index) override |
| virtual void | setGeometry(const QRectF &geom) override |
Funciones protegidas reimplementadas
| virtual QSizeF | sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const override |
Descripción detallada
El diseño de anclajes permite a los desarrolladores especificar cómo deben colocarse los widgets entre sí y con respecto al propio diseño. La especificación se realiza añadiendo anclajes al diseño mediante las funciones ` addAnchor()`, ` addAnchors()` o ` addCornerAnchors()`.
Se puede acceder a los anclajes existentes en el diseño mediante la función anchor(). Los elementos que están anclados se añaden automáticamente al diseño y, si se eliminan, todos sus anclajes se eliminarán automáticamente.

Uso de un diseño con anclajes para alinear widgets sencillos de colores.
Los anclajes siempre se establecen entre los bordes de un elemento, donde el «centro» también se considera un borde. Veamos el siguiente ejemplo:
layout->addAnchor(b, Qt::AnchorLeft, a, Qt::AnchorRight);
layout->addAnchor(b, Qt::AnchorTop, a, Qt::AnchorBottom);Aquí, el borde derecho del elemento a está anclado al borde izquierdo del elemento b y el borde inferior del elemento a está anclado al borde superior del elemento b, con el resultado de que el elemento b se colocará en diagonal a la derecha y por debajo del elemento b.
La función ` addCornerAnchors()` ofrece una forma más sencilla de anclar las esquinas de dos widgets que las dos llamadas individuales a ` addAnchor()` que se muestran en el código anterior. Aquí vemos cómo se puede anclar un widget a la esquina superior izquierda del diseño que lo contiene:
layout->addCornerAnchors(a, Qt::TopLeftCorner, layout, Qt::TopLeftCorner);En los casos en los que se utilizan anclajes para ajustar los anchos o las alturas de los widgets, resulta conveniente utilizar la función ` addAnchors()`. Al igual que con las demás funciones para especificar anclajes, también se puede utilizar para anclar un widget a un diseño.
Indicaciones de tamaño y políticas de tamaño en un diseño de anclaje
QGraphicsAnchorLayout respeta las sugerencias de tamaño y las políticas de tamaño de cada elemento. Ten en cuenta que hay algunas propiedades de QSizePolicy que son not respected.
Espaciado dentro de un diseño de anclaje
El diseño puede distribuir algo de espacio entre los elementos. Si el espaciado no se ha especificado explícitamente, la cantidad real de espacio suele ser 0.
Sin embargo, si el primer borde es opuesto al segundo (por ejemplo, el borde derecho del primer widget está anclado al borde izquierdo del segundo), el tamaño del anclaje se consultará en el estilo mediante una métrica en píxeles: PM_LayoutHorizontalSpacing para anclajes horizontales y PM_LayoutVerticalSpacing para anclajes verticales.
Si el espaciado es negativo, los elementos se solaparán en cierta medida.
Problemas conocidos
Hay algunas características que QGraphicsAnchorLayout no admite actualmente. Esto podría cambiar en el futuro, por lo que se recomienda evitar el uso de estas características si se desea evitar posibles regresiones en el comportamiento:
- No se respetan los factores de estiramiento.
- QSizePolicy::ExpandFlag No se respeta.
- No se respeta la relación altura/anchura.
Véase también QGraphicsLinearLayout, QGraphicsGridLayout y QGraphicsLayout.
Documentación de las funciones de miembro
QGraphicsAnchorLayout::QGraphicsAnchorLayout(QGraphicsLayoutItem *parent = nullptr)
Crea una instancia de `QGraphicsAnchorLayout`. Se pasa ` parent ` al constructor de ` QGraphicsLayout`.
[virtual noexcept] QGraphicsAnchorLayout::~QGraphicsAnchorLayout()
Elimina el objeto « QGraphicsAnchorLayout ».
QGraphicsAnchor *QGraphicsAnchorLayout::addAnchor(QGraphicsLayoutItem *firstItem, Qt::AnchorPoint firstEdge, QGraphicsLayoutItem *secondItem, Qt::AnchorPoint secondEdge)
Crea un anclaje entre el borde firstEdge del elemento firstItem y el borde secondEdge del elemento secondItem. El espaciado del anclaje se toma del estilo. Los anclajes entre un borde del diseño y un borde de un elemento tendrán un tamaño de 0. Si ya existe un anclaje entre los bordes, el nuevo anclaje sustituirá al anterior.
firstItem y secondItem se añaden automáticamente al diseño si no forman parte de él. Esto significa que count() puede aumentar hasta en 2.
El espaciado que tendrá un anclaje depende del tipo de anclaje. Por ejemplo, los anclajes desde el borde derecho de un elemento hasta el borde izquierdo de otro (o viceversa) utilizarán el espaciado horizontal predeterminado. El mismo comportamiento se aplica a los anclajes de «Abajo a Arriba» (pero utilizarán el espaciado vertical predeterminado). Para todas las demás combinaciones de anclajes, el espaciado será 0. Todas las funciones de anclaje seguirán esta regla.
El espaciado también se puede establecer manualmente utilizando el método QGraphicsAnchor::setSpacing().
La llamada a esta función cuando firstItem o secondItem son antepasados del diseño tiene un comportamiento indefinido.
Véase también addAnchors() y addCornerAnchors().
void QGraphicsAnchorLayout::addAnchors(QGraphicsLayoutItem *firstItem, QGraphicsLayoutItem *secondItem, Qt::Orientations orientations = Qt::Horizontal | Qt::Vertical)
Alinea dos o cuatro bordes de firstItem con los bordes correspondientes de secondItem, de modo que firstItem tenga el mismo tamaño que secondItem en las dimensiones especificadas por orientations.
Por ejemplo, en el siguiente ejemplo se anclan los bordes izquierdo y derecho de dos elementos para que coincidan sus anchos:
layout->addAnchor(b, Qt::AnchorLeft, c, Qt::AnchorLeft);
layout->addAnchor(b, Qt::AnchorRight, c, Qt::AnchorRight);Esto también se puede conseguir utilizando la siguiente línea de código:
layout->addAnchors(b, c, Qt::Horizontal);Véase también addAnchor() y addCornerAnchors().
void QGraphicsAnchorLayout::addCornerAnchors(QGraphicsLayoutItem *firstItem, Qt::Corner firstCorner, QGraphicsLayoutItem *secondItem, Qt::Corner secondCorner)
Crea dos anclajes entre firstItem y secondItem, especificados por las esquinas firstCorner y secondCorner, de los cuales uno corresponde al borde horizontal y el otro al borde vertical.
Se trata de una función práctica, ya que el anclaje de las esquinas puede expresarse como el anclaje de dos bordes. Por ejemplo:
layout->addAnchor(a, Qt::AnchorTop, layout, Qt::AnchorTop);
layout->addAnchor(a, Qt::AnchorLeft, layout, Qt::AnchorLeft);Esto también se puede conseguir con la siguiente línea de código:
layout->addCornerAnchors(a, Qt::TopLeftCorner, layout, Qt::TopLeftCorner);Si ya existe un anclaje entre los pares de bordes, este se sustituirá por los anclajes que especifique esta función.
firstItem y secondItem se añaden automáticamente al diseño si no forman parte del mismo. Esto significa que count() puede aumentar hasta en 2.
Véase también addAnchor() y addAnchors().
QGraphicsAnchor *QGraphicsAnchorLayout::anchor(QGraphicsLayoutItem *firstItem, Qt::AnchorPoint firstEdge, QGraphicsLayoutItem *secondItem, Qt::AnchorPoint secondEdge)
Devuelve el ancla situada entre los puntos de anclaje definidos por firstItem, firstEdge, secondItem y secondEdge. Si no existe dicha ancla, la función devolverá 0.
[override virtual] int QGraphicsAnchorLayout::count() const
Reimplementa: QGraphicsLayout::count() const.
qreal QGraphicsAnchorLayout::horizontalSpacing() const
Devuelve el espaciado horizontal predeterminado para el diseño de anclaje.
Véase también verticalSpacing() y setHorizontalSpacing().
[override virtual] void QGraphicsAnchorLayout::invalidate()
Reimplementa: QGraphicsLayout::invalidate().
[override virtual] QGraphicsLayoutItem *QGraphicsAnchorLayout::itemAt(int index) const
Reimplementa: ` QGraphicsLayout::itemAt(int i) const`.
[override virtual] void QGraphicsAnchorLayout::removeAt(int index)
Reimplementa: ` QGraphicsLayout::removeAt(int index)`.
Elimina el elemento de diseño situado en index sin destruirlo. La propiedad del elemento se transfiere a quien realiza la llamada.
Al eliminar un elemento, también se eliminarán todos los anclajes asociados a él.
Véase también itemAt() y count().
[override virtual] void QGraphicsAnchorLayout::setGeometry(const QRectF &geom)
Reimplementa: QGraphicsLayoutItem::setGeometry(const QRectF &rect).
void QGraphicsAnchorLayout::setHorizontalSpacing(qreal spacing)
Establece el espaciado horizontal predeterminado para el diseño de anclajes en spacing.
Véase también horizontalSpacing(), setVerticalSpacing() y setSpacing().
void QGraphicsAnchorLayout::setSpacing(qreal spacing)
Establece el espaciado horizontal y vertical predeterminados para la disposición de los enlaces en « spacing ».
Si un elemento se ancla sin ningún espaciado asociado al anclaje, se utilizará el espaciado predeterminado.
QGraphicsAnchorLayout No admite espaciados negativos. Si se establece un valor negativo, se desactivará el espaciado anterior y la disposición utilizará el espaciado proporcionado por el estilo actual del widget.
Véase también setHorizontalSpacing() y setVerticalSpacing().
void QGraphicsAnchorLayout::setVerticalSpacing(qreal spacing)
Establece el espaciado vertical predeterminado para la disposición de los enlaces en spacing.
Véase también verticalSpacing(), setHorizontalSpacing() y setSpacing().
[override virtual protected] QSizeF QGraphicsAnchorLayout::sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const
Reimplementa: ` QGraphicsLayoutItem::sizeHint` (`Qt::SizeHint which, const QSizeF &constraint) const`.
qreal QGraphicsAnchorLayout::verticalSpacing() const
Devuelve el espaciado vertical predeterminado para el diseño de anclaje.
Véase también horizontalSpacing() y setVerticalSpacing().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.