/******************************************************************************
 * 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