QskSkin.h

/******************************************************************************
 * QSkinny - Copyright (C) The authors
 *           SPDX-License-Identifier: BSD-3-Clause
 *****************************************************************************/
 
#ifndef QSK_SKIN_H
#define QSK_SKIN_H
 
#include "QskAspect.h"
 
#include <qcolor.h>
#include <qobject.h>
 
#include <memory>
#include <type_traits>
 
class QskSkinnable;
class QskSkinlet;
 
class QskColorFilter;
class QskGraphic;
class QskGraphicProvider;
class QskFontRole;
 
class QskSkinHintTable;
 
class QVariant;
template< typename Key, typename T > class QHash;
 
class QSK_EXPORT QskSkin : public QObject
{
    Q_OBJECT
 
    using Inherited = QObject;
 
  public:
#if 1
    // Use Qt::ColorScheme once minimum version is Qt 6.5
    enum ColorScheme
    {
        UnknownScheme,
 
        LightScheme,
        DarkScheme
    };
    Q_ENUM( ColorScheme )
#endif
 
    QskSkin( QObject* parent = nullptr );
    ~QskSkin() override;
 
    template< typename Control, typename Skinlet >
    void declareSkinlet();
 
    void setSkinHint( QskAspect, const QVariant& hint );
    const QVariant& skinHint( QskAspect ) const;
 
    void setGraphicFilter( int graphicRole, const QskColorFilter& );
    void resetGraphicFilter( int graphicRole );
    QskColorFilter graphicFilter( int graphicRole ) const;
 
    void setFont( const QskFontRole&, const QFont& );
    void resetFont( const QskFontRole& );
    QFont font( const QskFontRole& ) const;
 
    void addGraphicProvider( const QString& providerId, QskGraphicProvider* );
    QskGraphicProvider* graphicProvider( const QString& providerId ) const;
    bool hasGraphicProvider() const;
 
    virtual const int* dialogButtonLayout( Qt::Orientation ) const;
    virtual QString dialogButtonText( int button ) const;
 
    QskSkinlet* skinlet( const QMetaObject* );
    const QMetaObject* skinletMetaObject( const QMetaObject* ) const;
 
    const QskSkinHintTable& hintTable() const;
    QskSkinHintTable& hintTable();
 
    const QHash< QskFontRole, QFont >& fontTable() const;
    const QHash< int, QskColorFilter >& graphicFilters() const;
 
    ColorScheme colorScheme() const;
 
  public Q_SLOTS:
    void setColorScheme( ColorScheme );
 
  Q_SIGNALS:
    void colorSchemeChanged( ColorScheme );
 
  protected:
    void clearHints();
    virtual void initHints() = 0;
 
    void setupFontTable( const QString& family, bool italic = false );
    void completeFontTable();
 
  private:
    void declareSkinlet( const QMetaObject* metaObject,
        const QMetaObject* skinletMetaObject );
 
    class PrivateData;
    std::unique_ptr< PrivateData > m_data;
};
 
template< typename Skinnable, typename Skinlet >
inline void QskSkin::declareSkinlet()
{
    Q_STATIC_ASSERT( ( std::is_base_of< QskSkinnable, Skinnable >::value ) );
    Q_STATIC_ASSERT( ( std::is_base_of< QskSkinlet, Skinlet >::value ) );
    declareSkinlet( &Skinnable::staticMetaObject, &Skinlet::staticMetaObject );
}
 
#endif