PropertyContainer.h

Go to the documentation of this file.

/* -*- c-basic-offset: 4 indent-tabs-mode: nil -*-  vi:set ts=8 sts=4 sw=4: */

/*
    Sonic Visualiser
    An audio file viewer and annotation editor.
    Centre for Digital Music, Queen Mary, University of London.
    This file copyright 2006 Chris Cannam and QMUL.
    
    This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU General Public License as
    published by the Free Software Foundation; either version 2 of the
    License, or (at your option) any later version.  See the file
    COPYING included with this distribution for more information.
*/

#ifndef _PROPERTY_CONTAINER_H_
#define _PROPERTY_CONTAINER_H_

#include "Command.h"

#include <QString>
#include <QObject>
#include <vector>

class PlayParameters;
class RangeMapper;

class PropertyContainer : public QObject
{
    Q_OBJECT

public:
    virtual ~PropertyContainer() { }

    typedef QString PropertyName;
    typedef std::vector<PropertyName> PropertyList;
    
    enum PropertyType {
        ToggleProperty, // on or off
        RangeProperty, // range of integers
        ValueProperty, // range of integers given string labels
        ColourProperty, // colours, get/set as ColourDatabase indices
        UnitsProperty, // unit from UnitDatabase, get/set unit id
        InvalidProperty, // property not found!
    };

    virtual PropertyList getProperties() const;

    virtual QString getPropertyLabel(const PropertyName &) const = 0;

    virtual PropertyType getPropertyType(const PropertyName &) const;

    virtual QString getPropertyIconName(const PropertyName &) const;

    virtual QString getPropertyGroupName(const PropertyName &) const;

    virtual int getPropertyRangeAndValue(const PropertyName &,
                                         int *min, int *max, int *deflt) const;

    virtual QString getPropertyValueLabel(const PropertyName &,
                                          int value) const;

    virtual RangeMapper *getNewPropertyRangeMapper(const PropertyName &) const;

    virtual QString getPropertyContainerName() const = 0;
    virtual QString getPropertyContainerIconName() const = 0;

    virtual PlayParameters *getPlayParameters() { return 0; }

signals:
    void propertyChanged(PropertyContainer::PropertyName);

public slots:
    virtual void setProperty(const PropertyName &, int value);

    virtual void setPropertyWithCommand(const PropertyName &, int value);

    virtual void setProperty(QString nameString, QString valueString);

    virtual void setPropertyWithCommand(QString nameString, QString valueString);

protected:

    class SetPropertyCommand : public Command
    {
    public:
        SetPropertyCommand(PropertyContainer *pc, const PropertyName &pn, int);
        virtual ~SetPropertyCommand() { }

        virtual void execute();
        virtual void unexecute();
        virtual QString getName() const;

    protected:
        PropertyContainer *m_pc;
        PropertyName m_pn;
        int m_value;
        int m_oldValue;
    };

    virtual bool convertPropertyStrings(QString nameString, QString valueString,
                                        PropertyName &name, int &value);
};

#endif

---