columnformatters.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: Copyright (C) 2013 swift Project Community / Contributors
// SPDX-License-Identifier: GPL-3.0-or-later OR LicenseRef-swift-pilot-client-1
 
 
#ifndef SWIFT_GUI_MODELS_COLUMNFORMATTERS_H
#define SWIFT_GUI_MODELS_COLUMNFORMATTERS_H
 
#include <QFlags>
#include <QList>
#include <QString>
#include <Qt>
#include <QtGlobal>
 
#include "gui/led.h"
#include "gui/swiftguiexport.h"
#include "misc/icon.h"
#include "misc/icons.h"
#include "misc/pq/angle.h"
#include "misc/pq/frequency.h"
#include "misc/pq/length.h"
#include "misc/pq/speed.h"
#include "misc/pq/units.h"
#include "misc/variant.h"
 
namespace swift::gui::models
{
    class SWIFT_GUI_EXPORT CDefaultFormatter
    {
    public:
        CDefaultFormatter(int alignment = alignDefault(), bool i18n = true,
                          const QList<int> &supportedRoles = { Qt::DisplayRole })
            : m_supportedRoles(supportedRoles), m_alignment(alignment), m_useI18n(i18n)
        {}
 
        virtual ~CDefaultFormatter() {}
 
        CDefaultFormatter(const CDefaultFormatter &) = default;
 
        CDefaultFormatter &operator=(const CDefaultFormatter &) = default;
 
        virtual Qt::ItemFlags flags(Qt::ItemFlags flags, bool editable) const;
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &dataCVariant) const;
 
        virtual swift::misc::CVariant editRole(const swift::misc::CVariant &dataCVariant) const;
 
        virtual swift::misc::CVariant tooltipRole(const swift::misc::CVariant &value) const;
 
        virtual swift::misc::CVariant decorationRole(const swift::misc::CVariant &dataCVariant) const;
 
        virtual swift::misc::CVariant alignmentRole() const;
 
        virtual swift::misc::CVariant checkStateRole(const swift::misc::CVariant &value) const;
 
        virtual bool hasAlignment() const { return m_alignment >= 0; }
 
        bool supportsRole(int role) const;
 
        virtual swift::misc::CVariant data(int role, const swift::misc::CVariant &inputData) const;
 
        static int alignDefault();
 
        static int alignLeftVCenter() { return Qt::AlignVCenter | Qt::AlignLeft; }
 
        static int alignLeftTop() { return Qt::AlignTop | Qt::AlignLeft; }
 
        static int alignCentered() { return Qt::AlignVCenter | Qt::AlignHCenter; }
 
        static int alignRightVCenter() { return Qt::AlignVCenter | Qt::AlignRight; }
 
        static const QList<int> &roleDisplay()
        {
            static const QList<int> r({ Qt::DisplayRole });
            return r;
        }
 
        static const QList<int> &rolesDisplayAndEdit()
        {
            static const QList<int> r({ Qt::DisplayRole, Qt::EditRole });
            return r;
        }
 
        static const QList<int> &rolesDecorationAndToolTip()
        {
            static const QList<int> r({ Qt::DecorationRole, Qt::ToolTipRole });
            return r;
        }
 
        static const QList<int> &roleCheckState()
        {
            static const QList<int> r({ Qt::CheckStateRole });
            return r;
        }
 
        static const QList<int> &rolesNone()
        {
            static const QList<int> r;
            return r;
        }
 
    protected:
        virtual swift::misc::CVariant
        keepStandardTypesConvertToStringOtherwise(const swift::misc::CVariant &inputData) const;
 
        static const swift::misc::CVariant &emptyStringVariant();
 
        static const swift::misc::CVariant &emptyPixmapVariant();
 
        QList<int> m_supportedRoles = roleDisplay(); 
        int m_alignment = -1; 
        bool m_useI18n = true; 
    };
 
    class CPixmapFormatter : public CDefaultFormatter
    {
    public:
        CPixmapFormatter(int alignment = alignDefault(), const QList<int> &supportedRoles = rolesDecorationAndToolTip())
            : CDefaultFormatter(alignment, false, supportedRoles)
        {}
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &dataCVariant) const override;
 
        virtual swift::misc::CVariant tooltipRole(const swift::misc::CVariant &dataCVariant) const override;
 
        virtual swift::misc::CVariant decorationRole(const swift::misc::CVariant &dataCVariant) const override;
 
        int getMaxWidth() const { return m_maxWidth; }
        int getMaxHeight() const { return m_maxHeight; }
        void setMaxWidth(int w) { m_maxWidth = w; }
        void setMaxHeight(int h) { m_maxHeight = h; }
 
    private:
        int m_maxWidth = -1;
        int m_maxHeight = -1;
    };
 
    class CStringFormatter : public CDefaultFormatter
    {
    public:
        CStringFormatter(int alignment = alignDefault()) : CDefaultFormatter(alignment, false, roleDisplay()) {}
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &dataCVariant) const override;
    };
 
    class CEmptyFormatter : public CDefaultFormatter
    {
    public:
        CEmptyFormatter(int alignment = alignDefault()) : CDefaultFormatter(alignment, false, roleDisplay()) {}
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &dataCVariant) const override;
    };
 
    class CIncognitoFormatter : public CDefaultFormatter
    {
    public:
        CIncognitoFormatter(int alignment = alignDefault()) : CDefaultFormatter(alignment, false, roleDisplay()) {}
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &dataCVariant) const override;
    };
 
    class CDelegateFormatter : public CDefaultFormatter
    {
    public:
        CDelegateFormatter(int alignment = alignCentered(),
                           const QList<int> &supportedRoles = rolesDecorationAndToolTip())
            : CDefaultFormatter(alignment, false, supportedRoles)
        {}
 
        virtual Qt::ItemFlags flags(Qt::ItemFlags flags, bool editable) const override;
    };
 
    class CBoolTextFormatter : public CDefaultFormatter
    {
    public:
        CBoolTextFormatter(int alignment = alignDefault(), const QString &trueName = "true",
                           const QString &falseName = "false", const QList<int> &supportedRoles = roleDisplay())
            : CDefaultFormatter(alignment, false, supportedRoles),
              m_trueNameVariant(swift::misc::CVariant::from(trueName)),
              m_falseNameVariant(swift::misc::CVariant::from(falseName))
        {}
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &dataCVariant) const override;
 
        virtual Qt::ItemFlags flags(Qt::ItemFlags flags, bool editable) const override;
 
    protected:
        const swift::misc::CVariant m_trueNameVariant = "true"; 
        const swift::misc::CVariant m_falseNameVariant = "false"; 
    };
 
    class CBoolLedFormatter : public CBoolTextFormatter
    {
    public:
        CBoolLedFormatter(int alignment = alignDefault());
 
        CBoolLedFormatter(const QString &onName, const QString &offName, int alignment = alignDefault());
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &dataCVariant) const override;
 
        virtual swift::misc::CVariant decorationRole(const swift::misc::CVariant &dataCVariant) const override;
 
        virtual swift::misc::CVariant tooltipRole(const swift::misc::CVariant &dataCVariant) const override
        {
            return CBoolTextFormatter::displayRole(dataCVariant);
        }
 
    protected:
        swift::misc::CVariant m_pixmapOnLedVariant; 
        swift::misc::CVariant m_pixmapOffLedVariant; 
 
    private:
        static CLedWidget *createLedDefault()
        {
            return new CLedWidget(false, CLedWidget::Yellow, CLedWidget::Black, CLedWidget::Rounded);
        }
    };
 
    class CBoolIconFormatter : public CBoolTextFormatter
    {
    public:
        CBoolIconFormatter(int alignment = alignCentered());
 
        CBoolIconFormatter(const QString &onName, const QString &offName, int alignment = alignCentered());
 
        CBoolIconFormatter(const swift::misc::CIcon &onIcon, const swift::misc::CIcon &offIcon, const QString &onName,
                           const QString &offName, int alignment = alignCentered());
 
        CBoolIconFormatter(swift::misc::CIcons::IconIndex onIcon, swift::misc::CIcons::IconIndex offIcon,
                           const QString &onName, const QString &offName, int alignment = alignCentered());
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &dataCVariant) const override;
 
        virtual swift::misc::CVariant decorationRole(const swift::misc::CVariant &dataCVariant) const override;
 
        virtual swift::misc::CVariant tooltipRole(const swift::misc::CVariant &dataCVariant) const override;
 
    protected:
        const swift::misc::CVariant m_iconOnVariant; 
        const swift::misc::CVariant m_iconOffVariant; 
    };
 
    class CValueObjectFormatter : public CDefaultFormatter
    {
    public:
        CValueObjectFormatter(int alignment = alignDefault(), bool i18n = true,
                              const QList<int> &supportedRoles = roleDisplay())
            : CDefaultFormatter(alignment, i18n, supportedRoles)
        {}
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &valueObject) const override;
 
        virtual swift::misc::CVariant decorationRole(const swift::misc::CVariant &valueObject) const override;
    };
 
    class CDateTimeFormatter : public CDefaultFormatter
    {
    public:
        CDateTimeFormatter(const QString &formatString = formatYmd(), int alignment = alignDefault(), bool i18n = true);
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &dateTime) const override;
 
        static const QString &formatYmd()
        {
            static const QString f = "yyyy-MM-dd";
            return f;
        }
 
        static const QString &formatYmdhm()
        {
            static const QString f = "yyyy-MM-dd HH:mm";
            return f;
        }
 
        static const QString &formatHm()
        {
            static const QString f = "HH:mm";
            return f;
        }
 
        static const QString &formatHms()
        {
            static const QString f = "HH:mm:ss";
            return f;
        }
 
        static const QString &formatHmsz()
        {
            static const QString f = "HH:mm:ss.zzz";
            return f;
        }
 
    private:
        const QString m_formatString = "yyyy-MM-dd HH:mm"; 
    };
 
    class CIntegerFormatter : public CDefaultFormatter
    {
    public:
        CIntegerFormatter(int alignment = alignRightVCenter()) : CDefaultFormatter(alignment, false) {}
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &expectedInteger) const override;
    };
 
    class CAltitudeFormatter : public CDefaultFormatter
    {
    public:
        CAltitudeFormatter(bool flightlevel = false, int alignment = alignRightVCenter(), bool i18n = true)
            : CDefaultFormatter(alignment, i18n), m_flightLevel(flightlevel)
        {}
 
        CAltitudeFormatter(const swift::misc::physical_quantities::CLengthUnit &unit, bool flightlevel = false,
                           int alignment = alignRightVCenter(), bool i18n = true)
            : CDefaultFormatter(alignment, i18n), m_unit(unit), m_flightLevel(flightlevel)
        {}
 
        void setUnit(const swift::misc::physical_quantities::CLengthUnit &unit);
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &altitude) const override;
 
    private:
        swift::misc::physical_quantities::CLengthUnit m_unit = swift::misc::physical_quantities::CLengthUnit::ft();
        const bool m_flightLevel = false;
    };
 
    class CColorFormatter : public CDefaultFormatter
    {
    public:
        CColorFormatter(int alignment = alignCentered(), bool i18n = true);
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &dataCVariant) const override;
 
        virtual swift::misc::CVariant tooltipRole(const swift::misc::CVariant &dataCVariant) const override;
 
        virtual swift::misc::CVariant decorationRole(const swift::misc::CVariant &dataCVariant) const override;
    };
 
    template <class MU, class PQ>
    class CPhysiqalQuantiyFormatter : public CValueObjectFormatter
    {
    public:
        CPhysiqalQuantiyFormatter(MU unit = MU::defaultUnit(), int digits = 2, int alignment = alignRightVCenter(),
                                  bool withUnit = true, bool i18n = true,
                                  const QList<int> &supportedRoles = roleDisplay())
            : CValueObjectFormatter(alignment, i18n, supportedRoles), m_unit(unit), m_digits(digits),
              m_withUnit(withUnit)
        {}
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &physicalQuantity) const override
        {
            if (physicalQuantity.canConvert<PQ>())
            {
                const PQ pq = physicalQuantity.value<PQ>();
                return this->displayRole(pq);
            }
            else
            {
                Q_ASSERT_X(false, "CPhysiqalQuantiyFormatter::displayRole", "No CPhysicalQuantity class");
                return emptyStringVariant();
            }
        }
 
        swift::misc::CVariant displayRole(const PQ &pq) const
        {
            if (pq.isNull())
            {
                static const swift::misc::CVariant null("null");
                return null;
            }
            return pq.valueRoundedWithUnit(m_unit, m_digits, m_useI18n);
        }
 
        virtual void setUnit(const MU &unit) { m_unit = unit; }
 
        virtual void enableUnit(bool enable) { m_withUnit = enable; }
 
        virtual void setDigits(int digits) { m_digits = digits; }
 
    protected:
        MU m_unit; 
        int m_digits = 2; 
        bool m_withUnit = true; 
    };
 
    class CComFrequencyFormatter :
        public CPhysiqalQuantiyFormatter<swift::misc::physical_quantities::CFrequencyUnit,
                                         swift::misc::physical_quantities::CFrequency>
    {
    public:
        CComFrequencyFormatter(int alignment = alignRightVCenter(), bool withUnit = true, bool i18n = true)
            : CPhysiqalQuantiyFormatter(swift::misc::physical_quantities::CFrequencyUnit::MHz(), 3, alignment, withUnit,
                                        i18n)
        {}
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &dataCVariant) const override;
    };
 
    class CAngleDegreeFormatter :
        public CPhysiqalQuantiyFormatter<swift::misc::physical_quantities::CAngleUnit,
                                         swift::misc::physical_quantities::CAngle>
    {
    public:
        CAngleDegreeFormatter(int alignment = alignRightVCenter(), bool withUnit = true, bool i18n = true)
            : CPhysiqalQuantiyFormatter(swift::misc::physical_quantities::CAngleUnit::deg(), 0, alignment, withUnit,
                                        i18n)
        {}
    };
 
    class CLatLonFormatter : public CValueObjectFormatter
    {
    public:
        CLatLonFormatter(int alignment = alignRightVCenter()) : CValueObjectFormatter(alignment) {}
    };
 
    class CAirspaceDistanceFormatter :
        public CPhysiqalQuantiyFormatter<swift::misc::physical_quantities::CLengthUnit,
                                         swift::misc::physical_quantities::CLength>
    {
    public:
        CAirspaceDistanceFormatter(int alignment = alignRightVCenter(), bool withUnit = true, bool i18n = true)
            : CPhysiqalQuantiyFormatter(swift::misc::physical_quantities::CLengthUnit::NM(), 1, alignment, withUnit,
                                        i18n)
        {}
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &dataCVariant) const override;
    };
 
    class CSpeedKtsFormatter :
        public CPhysiqalQuantiyFormatter<swift::misc::physical_quantities::CSpeedUnit,
                                         swift::misc::physical_quantities::CSpeed>
    {
    public:
        CSpeedKtsFormatter(int alignment = alignRightVCenter(), bool withUnit = true, bool i18n = true)
            : CPhysiqalQuantiyFormatter(swift::misc::physical_quantities::CSpeedUnit::kts(), 0, alignment, withUnit,
                                        i18n)
        {}
 
        virtual swift::misc::CVariant displayRole(const swift::misc::CVariant &dataCVariant) const override;
    };
} // namespace swift::gui::models
 
#endif // SWIFT_GUI_MODELS_COLUMNFORMATTERS_H