b89621a3d4
* add QskArcNode and QskArcRenderer * IOT example: Use QskArcNode instead of own arc node * move some functionality to the arc renderer * add QskArcMetrics * add methods to QskSkinlet * remove circular bar graph node We can now use updateArcNode() and don't need our own method. * support linear gradients in the arc renderer * clean up * incorporate Uwe's changes * add overloads for updateArcNode() when the angles are set dynamically The angles don't always come from the style, so we need overloads in QskSkinlet to set them dynamically.
265 lines
8.1 KiB
C++
265 lines
8.1 KiB
C++
/******************************************************************************
|
|
* QSkinny - Copyright (C) 2016 Uwe Rathmann
|
|
* This file may be used under the terms of the QSkinny License, Version 1.0
|
|
*****************************************************************************/
|
|
|
|
#ifndef QSK_SKINNABLE_H
|
|
#define QSK_SKINNABLE_H
|
|
|
|
#include "QskAspect.h"
|
|
#include <memory>
|
|
|
|
typedef unsigned int QRgb;
|
|
class QSizeF;
|
|
class QRectF;
|
|
class QColor;
|
|
class QFont;
|
|
class QMarginsF;
|
|
struct QMetaObject;
|
|
class QVariant;
|
|
class QDebug;
|
|
|
|
class QSGNode;
|
|
|
|
class QskArcMetrics;
|
|
class QskControl;
|
|
class QskAnimationHint;
|
|
class QskColorFilter;
|
|
class QskBoxShapeMetrics;
|
|
class QskBoxBorderMetrics;
|
|
class QskBoxBorderColors;
|
|
class QskGradient;
|
|
|
|
class QskSkin;
|
|
class QskSkinlet;
|
|
class QskSkinHintTable;
|
|
|
|
class QSK_EXPORT QskSkinHintStatus
|
|
{
|
|
public:
|
|
enum Source
|
|
{
|
|
NoSource = 0,
|
|
|
|
Skinnable,
|
|
Skin,
|
|
Animator
|
|
};
|
|
|
|
QskSkinHintStatus()
|
|
: source( NoSource )
|
|
{
|
|
}
|
|
|
|
inline bool isValid() const
|
|
{
|
|
return source > 0;
|
|
}
|
|
|
|
Source source;
|
|
QskAspect aspect;
|
|
};
|
|
|
|
#ifndef QT_NO_DEBUG_STREAM
|
|
|
|
class QDebug;
|
|
QSK_EXPORT QDebug operator<<( QDebug, const QskSkinHintStatus& );
|
|
|
|
#endif
|
|
|
|
class QSK_EXPORT QskSkinnable
|
|
{
|
|
public:
|
|
QskSkinnable();
|
|
virtual ~QskSkinnable();
|
|
|
|
void setSkinlet( const QskSkinlet* );
|
|
const QskSkinlet* skinlet() const;
|
|
|
|
QFont effectiveFont( QskAspect ) const;
|
|
|
|
QskColorFilter effectiveGraphicFilter( QskAspect ) const;
|
|
|
|
void setSubcontrolProxy( QskAspect::Subcontrol, QskAspect::Subcontrol proxy );
|
|
void resetSubcontrolProxy( QskAspect::Subcontrol );
|
|
QskAspect::Subcontrol subcontrolProxy( QskAspect::Subcontrol ) const;
|
|
|
|
bool setAnimationHint( QskAspect, QskAnimationHint );
|
|
QskAnimationHint animationHint( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
bool setSkinHint( QskAspect, const QVariant& );
|
|
bool resetSkinHint( QskAspect );
|
|
|
|
QskAnimationHint effectiveAnimation( QskAspect::Type, QskAspect::Subcontrol,
|
|
QskAspect::States, QskSkinHintStatus* status = nullptr ) const;
|
|
|
|
QVariant effectiveSkinHint( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
virtual QskAspect::Placement effectivePlacement() const;
|
|
|
|
QskSkinHintStatus hintStatus( QskAspect ) const;
|
|
|
|
QRectF subControlRect( const QRectF&, QskAspect::Subcontrol ) const;
|
|
QRectF subControlContentsRect( const QRectF&, QskAspect::Subcontrol ) const;
|
|
|
|
QSizeF outerBoxSize( QskAspect, const QSizeF& innerBoxSize ) const;
|
|
QSizeF innerBoxSize( QskAspect, const QSizeF& outerBoxSize ) const;
|
|
|
|
QRectF innerBox( QskAspect, const QRectF& outerBox ) const;
|
|
QRectF outerBox( QskAspect, const QRectF& innerBox ) const;
|
|
|
|
QMarginsF innerPadding( QskAspect, const QSizeF& ) const;
|
|
|
|
const QskSkinlet* effectiveSkinlet() const;
|
|
QskSkin* effectiveSkin() const;
|
|
|
|
void startTransition( QskAspect,
|
|
QskAnimationHint, QVariant from, QVariant to );
|
|
|
|
QskAspect::Subcontrol effectiveSubcontrol( QskAspect::Subcontrol ) const;
|
|
|
|
QskControl* controlCast();
|
|
const QskControl* controlCast() const;
|
|
|
|
virtual QskControl* owningControl() const = 0;
|
|
virtual const QMetaObject* metaObject() const = 0;
|
|
|
|
void debug( QskAspect ) const;
|
|
void debug( QskAspect::State ) const;
|
|
void debug( QDebug, QskAspect ) const;
|
|
void debug( QDebug, QskAspect::State ) const;
|
|
|
|
void setSkinStates( QskAspect::States );
|
|
void setSkinStateFlag( QskAspect::State, bool on = true );
|
|
|
|
void addSkinStates( QskAspect::States );
|
|
void clearSkinStates( QskAspect::States );
|
|
|
|
void replaceSkinStates( QskAspect::States );
|
|
|
|
bool hasSkinState( QskAspect::State ) const;
|
|
QskAspect::States skinStates() const;
|
|
|
|
const char* skinStatesAsPrintable() const;
|
|
const char* skinStatesAsPrintable( QskAspect::States ) const;
|
|
|
|
// type aware methods for accessing skin hints
|
|
|
|
bool setColor( QskAspect, Qt::GlobalColor );
|
|
bool setColor( QskAspect, QRgb );
|
|
bool setColor( QskAspect, const QColor& );
|
|
bool resetColor( QskAspect );
|
|
QColor color( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
bool setMetric( QskAspect, qreal );
|
|
bool resetMetric( QskAspect );
|
|
qreal metric( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
bool setFlagHint( QskAspect, int flag );
|
|
bool resetFlagHint( QskAspect );
|
|
int flagHint( QskAspect ) const;
|
|
template< typename T > T flagHint( QskAspect, T = T() ) const;
|
|
|
|
bool setStrutSizeHint( QskAspect, const QSizeF& );
|
|
bool setStrutSizeHint( QskAspect, qreal width, qreal height );
|
|
bool resetStrutSizeHint( QskAspect );
|
|
QSizeF strutSizeHint( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
bool setMarginHint( QskAspect, qreal );
|
|
bool setMarginHint( QskAspect, const QMarginsF& );
|
|
bool resetMarginHint( QskAspect );
|
|
QMarginsF marginHint( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
bool setPaddingHint( QskAspect, qreal );
|
|
bool setPaddingHint( QskAspect, const QMarginsF& );
|
|
bool resetPaddingHint( QskAspect );
|
|
QMarginsF paddingHint( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
bool setGradientHint( QskAspect, const QskGradient& );
|
|
QskGradient gradientHint( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
bool setBoxShapeHint( QskAspect, const QskBoxShapeMetrics& );
|
|
bool resetBoxShapeHint( QskAspect );
|
|
QskBoxShapeMetrics boxShapeHint( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
bool setBoxBorderMetricsHint( QskAspect, const QskBoxBorderMetrics& );
|
|
bool resetBoxBorderMetricsHint( QskAspect );
|
|
QskBoxBorderMetrics boxBorderMetricsHint(
|
|
QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
bool setBoxBorderColorsHint( QskAspect, const QskBoxBorderColors& );
|
|
bool resetBoxBorderColorsHint( QskAspect );
|
|
QskBoxBorderColors boxBorderColorsHint( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
bool setArcMetricsHint( QskAspect, const QskArcMetrics& );
|
|
bool resetArcMetricsHint( QskAspect );
|
|
QskArcMetrics arcMetricsHint( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
bool setSpacingHint( QskAspect, qreal );
|
|
bool resetSpacingHint( QskAspect );
|
|
qreal spacingHint( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
bool setAlignmentHint( QskAspect, Qt::Alignment );
|
|
bool resetAlignmentHint( QskAspect );
|
|
Qt::Alignment alignmentHint( QskAspect, Qt::Alignment = Qt::Alignment() ) const;
|
|
|
|
bool setFontRoleHint( QskAspect, int role );
|
|
bool resetFontRoleHint( QskAspect );
|
|
int fontRoleHint( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
bool setGraphicRoleHint( QskAspect, int role );
|
|
bool resetGraphicRoleHint( QskAspect );
|
|
int graphicRoleHint( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
protected:
|
|
virtual void updateNode( QSGNode* );
|
|
virtual bool isTransitionAccepted( QskAspect ) const;
|
|
|
|
virtual QskAspect::Subcontrol substitutedSubcontrol( QskAspect::Subcontrol ) const;
|
|
|
|
QskSkinHintTable& hintTable();
|
|
const QskSkinHintTable& hintTable() const;
|
|
|
|
private:
|
|
void startHintTransition( QskAspect,
|
|
QskAnimationHint, QVariant from, QVariant to );
|
|
|
|
QVariant animatedValue( QskAspect, QskSkinHintStatus* ) const;
|
|
const QVariant& storedHint( QskAspect, QskSkinHintStatus* = nullptr ) const;
|
|
|
|
class PrivateData;
|
|
std::unique_ptr< PrivateData > m_data;
|
|
};
|
|
|
|
template< typename T >
|
|
inline T QskSkinnable::flagHint( QskAspect aspect, T defaultValue ) const
|
|
{
|
|
const auto& hint = effectiveSkinHint( aspect );
|
|
if ( hint.isValid() && hint.canConvert< int >() )
|
|
return static_cast< T >( hint.value< int >() );
|
|
|
|
return defaultValue;
|
|
}
|
|
|
|
inline Qt::Alignment QskSkinnable::alignmentHint(
|
|
QskAspect aspect, Qt::Alignment defaultAlignment ) const
|
|
{
|
|
return flagHint< Qt::Alignment >( aspect | QskAspect::Alignment, defaultAlignment );
|
|
}
|
|
|
|
inline bool QskSkinnable::resetColor( QskAspect aspect )
|
|
{
|
|
return resetSkinHint( aspect | QskAspect::Color );
|
|
}
|
|
|
|
inline bool QskSkinnable::resetMetric( QskAspect aspect )
|
|
{
|
|
return resetSkinHint( aspect | QskAspect::Metric );
|
|
}
|
|
|
|
inline bool QskSkinnable::resetFlagHint( QskAspect aspect )
|
|
{
|
|
return resetSkinHint( aspect | QskAspect::Flag );
|
|
}
|
|
|
|
#endif
|