QskControl.h

/******************************************************************************
 * QSkinny - Copyright (C) The authors
 *           SPDX-License-Identifier: BSD-3-Clause
 *****************************************************************************/
 
#ifndef QSK_CONTROL_H
#define QSK_CONTROL_H
 
#include "QskItem.h"
#include "QskSkinnable.h"
#include "QskAspect.h"
#include "QskGradient.h"
#include "QskSizePolicy.h"
#include "QskPlacementPolicy.h"
 
#include <qlocale.h>
#include <memory>
 
class QskControlPrivate;
class QskGestureEvent;
 
class QSK_EXPORT QskControl : public QskItem, public QskSkinnable
{
    Q_OBJECT
 
    Q_PROPERTY( QLocale locale READ locale
        WRITE setLocale RESET resetLocale NOTIFY localeChanged )
 
    Q_PROPERTY( QskAspect::Section section READ section
        WRITE setSection RESET resetSection NOTIFY sectionChanged )
 
    Q_PROPERTY( bool autoLayoutChildren READ autoLayoutChildren
        WRITE setAutoLayoutChildren )
 
    Q_PROPERTY( bool visibleToLayout READ isVisibleToLayout )
 
    Q_PROPERTY( QskMargins margins READ margins
        WRITE setMargins RESET resetMargins NOTIFY marginsChanged )
 
    Q_PROPERTY( QskGradient background READ background
        WRITE setBackground RESET resetBackground NOTIFY backgroundChanged )
 
    Q_PROPERTY( QskSizePolicy sizePolicy READ sizePolicy WRITE setSizePolicy )
    Q_PROPERTY( QskPlacementPolicy placementPolicy READ placementPolicy
        WRITE setPlacementPolicy RESET resetPlacementPolicy )
 
    Q_PROPERTY( QSizeF minimumSize READ minimumSize WRITE setMinimumSize )
    Q_PROPERTY( QSizeF maximumSize READ maximumSize WRITE setMaximumSize )
    Q_PROPERTY( QSizeF preferredSize READ preferredSize WRITE setPreferredSize )
    Q_PROPERTY( QSizeF sizeConstraint READ sizeConstraint )
 
    using Inherited = QskItem;
 
  public:
    QSK_SUBCONTROLS( Background )
    QSK_STATES( Disabled, Hovered, Focused )
 
    QskControl( QQuickItem* parent = nullptr );
    ~QskControl() override;
 
    void setMargins( qreal );
    void setMargins( qreal, qreal, qreal, qreal );
    void setMargins( const QMarginsF& );
    void resetMargins();
    QMarginsF margins() const;
 
    void setBackground( const QskGradient& );
    void resetBackground();
    QskGradient background() const;
 
    void setBackgroundColor( const QColor& );
 
    QRectF contentsRect() const;
    QRectF layoutRect() const;
 
    virtual QRectF layoutRectForSize( const QSizeF& ) const;
 
    virtual QRectF focusIndicatorRect() const;
    virtual QRectF focusIndicatorClipRect() const;
 
    using QskSkinnable::subControlRect;
    QRectF subControlRect( QskAspect::Subcontrol ) const;
    QRectF subControlRect( const QSizeF&, QskAspect::Subcontrol ) const;
 
    using QskSkinnable::subControlContentsRect;
    QRectF subControlContentsRect( QskAspect::Subcontrol ) const;
    QRectF subControlContentsRect( const QSizeF&, QskAspect::Subcontrol ) const;
 
    void setAutoLayoutChildren( bool );
    bool autoLayoutChildren() const;
 
    void setSection( QskAspect::Section );
    void resetSection();
    QskAspect::Section section() const override final;
 
    void setSizePolicy( QskSizePolicy );
    void setSizePolicy( QskSizePolicy::Policy, QskSizePolicy::Policy );
    void setSizePolicy( Qt::Orientation, QskSizePolicy::Policy );
 
    QskSizePolicy sizePolicy() const;
    QskSizePolicy::Policy sizePolicy( Qt::Orientation ) const;
 
    // hints for how to be treated by layouts
    void setLayoutAlignmentHint( Qt::Alignment );
    Qt::Alignment layoutAlignmentHint() const;
 
    void setPlacementPolicy( QskPlacementPolicy );
    void setPlacementPolicy( QskPlacementPolicy::Policy, QskPlacementPolicy::Policy );
    void setPlacementPolicy( Qsk::Visibilities, QskPlacementPolicy::Policy );
    void resetPlacementPolicy();
 
    QskPlacementPolicy placementPolicy() const;
    QskPlacementPolicy::Policy placementPolicy( Qsk::Visibility ) const;
 
    QskPlacementPolicy::Policy effectivePlacementPolicy() const;
 
    bool isVisibleToLayout() const;
 
    void setMinimumSize( const QSizeF& );
    void setMinimumSize( qreal width, qreal height );
    void setMinimumWidth( qreal width );
    void setMinimumHeight( qreal height );
 
    void setMaximumSize( const QSizeF& );
    void setMaximumSize( qreal width, qreal height );
    void setMaximumWidth( qreal width );
    void setMaximumHeight( qreal height );
 
    void setPreferredSize( const QSizeF& );
    void setPreferredSize( qreal width, qreal height );
    void setPreferredWidth( qreal width );
    void setPreferredHeight( qreal height );
 
    void setFixedSize( const QSizeF& );
    void setFixedSize( qreal width, qreal height );
    void setFixedWidth( qreal width );
    void setFixedHeight( qreal height );
 
    void setExplicitSizeHint( Qt::SizeHint, const QSizeF& );
    void setExplicitSizeHint( Qt::SizeHint, qreal width, qreal height );
    void resetExplicitSizeHint( Qt::SizeHint );
 
    QSizeF minimumSize() const;
    QSizeF maximumSize() const;
    QSizeF preferredSize() const;
 
    QSizeF explicitSizeHint( Qt::SizeHint ) const;
    QSizeF implicitSizeHint( Qt::SizeHint, const QSizeF& constraint ) const;
 
    QSizeF sizeHint() const;
    qreal heightForWidth( qreal width ) const;
    qreal widthForHeight( qreal height ) const;
 
    QSizeF effectiveSizeHint( Qt::SizeHint,
        const QSizeF& constraint = QSizeF() ) const;
 
    QSizeF sizeConstraint( Qt::SizeHint, const QSizeF& constraint = QSizeF() ) const;
    QSizeF sizeConstraint() const;
 
    QLocale locale() const;
    void resetLocale();
 
    QVector< QskAspect::Subcontrol > subControls() const;
 
  Q_SIGNALS:
    void backgroundChanged();
    void sectionChanged( QskAspect::Section );
    void marginsChanged( const QMarginsF& );
    void focusIndicatorRectChanged();
    void localeChanged( const QLocale& );
 
  public Q_SLOTS:
    void setLocale( const QLocale& );
 
  protected:
    bool event( QEvent* ) override;
 
    virtual void gestureEvent( QskGestureEvent* );
 
    void hoverEnterEvent( QHoverEvent* ) override;
    void hoverLeaveEvent( QHoverEvent* ) override;
 
    bool childMouseEventFilter( QQuickItem*, QEvent* ) override;
 
    void itemChange( ItemChange, const ItemChangeData& ) override;
    void geometryChange( const QRectF&, const QRectF& ) override;
 
    void initSizePolicy( QskSizePolicy::Policy, QskSizePolicy::Policy );
 
    // called from updatePolish
    virtual void updateResources();
    virtual void updateLayout();
 
    virtual QSizeF contentsSizeHint( Qt::SizeHint, const QSizeF& ) const;
    virtual QSizeF layoutSizeHint( Qt::SizeHint, const QSizeF& ) const;
 
  private:
    void updateInputMethod( Qt::InputMethodQueries ) = delete; // use qskUpdateInputMethod
 
    QSGNode* updateItemPaintNode( QSGNode* ) override final;
    void updateItemPolish() override final;
 
    QskControl* owningItem() const override final;
 
  private:
    Q_DECLARE_PRIVATE( QskControl )
};
 
inline QSizeF QskControl::sizeConstraint() const
{
    return sizeConstraint( Qt::PreferredSize, QSizeF() );
}
 
inline QSizeF QskControl::sizeHint() const
{
    return effectiveSizeHint( Qt::PreferredSize );
}
 
inline QSizeF QskControl::minimumSize() const
{
    return effectiveSizeHint( Qt::MinimumSize );
}
 
inline QSizeF QskControl::maximumSize() const
{
    return effectiveSizeHint( Qt::MaximumSize );
}
 
inline QSizeF QskControl::preferredSize() const
{
    return effectiveSizeHint( Qt::PreferredSize );
}
 
inline QskControl* qskControlCast( QObject* object )
{
    return qobject_cast< QskControl* >( object );
}
 
inline const QskControl* qskControlCast( const QObject* object )
{
    return qobject_cast< const QskControl* >( object );
}
 
#endif