90 lines
2.7 KiB
C
90 lines
2.7 KiB
C
|
/******************************************************************************
|
||
|
|
* QSkinny - Copyright (C) The authors
|
||
|
|
* SPDX-License-Identifier: BSD-3-Clause
|
||
|
|
*****************************************************************************/
|
||
|
|
|
||
|
|
#ifndef QSK_ITEM_ANCHORS_H
|
||
|
|
#define QSK_ITEM_ANCHORS_H
|
||
|
|
|
||
|
|
#include "QskGlobal.h"
|
||
|
|
#include <qnamespace.h>
|
||
|
|
#include <qpointer.h>
|
||
|
|
|
||
|
|
class QMarginsF;
|
||
|
|
class QQuickItem;
|
||
|
|
|
||
|
|
/*
|
||
|
|
QskItemAnchors is a C++ API to access the Qt/Quick anchoring,
|
||
|
|
that has been designed to be used from QML.
|
||
|
|
|
||
|
|
Qt/Quick anchoring is a simple concept, that adjusts the
|
||
|
|
edges of the anchoredItem whenever the geometry of a baseItem
|
||
|
|
has changed. A baseItem needs to be the parent or a sibling
|
||
|
|
of the anchoredItem.
|
||
|
|
|
||
|
|
Note that Qt/Quick anchoring is labeled as "positioner", what means
|
||
|
|
that it is not capable of handling typical layout scenarios, like
|
||
|
|
distributing the space of a bounding rectangle to a chainn of
|
||
|
|
anchored children.
|
||
|
|
|
||
|
|
For some reason the implementation allows to define conflicting definitions
|
||
|
|
and resolves them by applying only one of the definitions in
|
||
|
|
the following precedence:
|
||
|
|
|
||
|
|
1) fill
|
||
|
|
2) centerIn
|
||
|
|
3) anchors
|
||
|
|
|
||
|
|
Limitations:
|
||
|
|
- access to baseline settings are not implemented
|
||
|
|
*/
|
||
|
|
class QSK_EXPORT QskItemAnchors
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
QskItemAnchors( QQuickItem* = nullptr );
|
||
|
|
~QskItemAnchors();
|
||
|
|
|
||
|
|
QQuickItem* anchoredItem() const;
|
||
|
|
|
||
|
|
QQuickItem* baseItem( Qt::AnchorPoint ) const;
|
||
|
|
Qt::AnchorPoint basePosition( Qt::AnchorPoint ) const;
|
||
|
|
|
||
|
|
bool operator==( const QskItemAnchors& ) const noexcept;
|
||
|
|
bool operator!=( const QskItemAnchors& ) const noexcept;
|
||
|
|
|
||
|
|
QMarginsF margins() const;
|
||
|
|
void setMargins( const QMarginsF& );
|
||
|
|
|
||
|
|
void setCenterOffset( Qt::Orientation, qreal offset );
|
||
|
|
qreal centerOffset( Qt::Orientation );
|
||
|
|
|
||
|
|
void addAnchor( Qt::AnchorPoint, QQuickItem*, Qt::AnchorPoint );
|
||
|
|
void addAnchors( Qt::Corner, QQuickItem*, Qt::Corner );
|
||
|
|
void addAnchors( QQuickItem*, Qt::Orientations = Qt::Horizontal | Qt::Vertical );
|
||
|
|
|
||
|
|
void removeAnchor( Qt::AnchorPoint );
|
||
|
|
|
||
|
|
/*
|
||
|
|
Qt/Quick anchoring knows the convenience modes "fill" and "centerIn".
|
||
|
|
Internally these modes are not(!) mapped to anchor definitions.
|
||
|
|
|
||
|
|
Both modes are setting the center point of the anchoredItem to the center
|
||
|
|
of the controlItem. "fill" also adjusts the size.
|
||
|
|
*/
|
||
|
|
|
||
|
|
QQuickItem* controlItem( bool adjustSize ) const;
|
||
|
|
void setControlItem( QQuickItem*, bool adjustSize );
|
||
|
|
void removeControlItem( bool adjustSize );
|
||
|
|
|
||
|
|
private:
|
||
|
|
QPointer< QQuickItem > m_anchoredItem;
|
||
|
|
};
|
||
|
|
|
||
|
|
inline bool QskItemAnchors::operator!=(
|
||
|
|
const QskItemAnchors& other ) const noexcept
|
||
|
|
{
|
||
|
|
return !( *this == other );
|
||
|
|
}
|
||
|
|
|
||
|
|
#endif
|