summaryrefslogtreecommitdiffstats
path: root/lib/widgets/propeditor/childproperty.h
blob: fc43553a3c9cf4d83f11d85e6a5177696307afb6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
/***************************************************************************
 *   Copyright (C) 2004 by Alexander Dymo                                  *
 *   cloudtemple@mskat.net                                                 *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU Library General Public License as       *
 *   published by the Free Software Foundation; either version 2 of the    *
 *   License, or (at your option) any later version.                       *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU Library General Public     *
 *   License along with this program; if not, write to the                 *
 *   Free Software Foundation, Inc.,                                       *
 *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.             *
 ***************************************************************************/
#ifndef CHILDPROPERTY_H
#define CHILDPROPERTY_H

#include "property.h"

namespace PropertyLib{

class MultiProperty;

/**
@short Child property

Child property is a detailed property for complex parent properties.
For example, to edit a property of Point type one can request two
child properties for "x" and "y" components of a point.

Child properties instances usually belong to MultiProperty class
which is used to fetch and display them in the property editor.
Child properties are created by a PropertyMachineFactory.
Factory in such case does not only creates a machine for a property,
but also fills corrresponding multiproperty with a list of child
properties.
*/
class ChildProperty: public Property{
public:
    enum ChildPropertyType {
        Size_Height,
        Size_Width,
        Point_X,
        Point_Y,
        Rect_X,
        Rect_Y,
        Rect_Width,
        Rect_Height,
        SizePolicy_HorData,
        SizePolicy_VerData,
        SizePolicy_HorStretch,
        SizePolicy_VerStretch
    };
    
    /**Constructs empty property.*/
    ChildProperty() {}
    /**Constructs property.*/
    ChildProperty(MultiProperty *parent, int type, ChildPropertyType childType, const QString &name,
        const QString &description, const QVariant &value = QVariant(),
        bool save = true, bool readOnly = false);
    /**Constructs property with @ref ValueFromList type.*/
    ChildProperty(MultiProperty *parent, const QString &name, ChildPropertyType childType,
        const QMap<QString, QVariant> &v_valueList, const QString &description,
        const QVariant &value = QVariant(), bool save = true, bool readOnly = false);

    /**@return the value of the property.*/
    virtual QVariant value() const;
    /**Sets the value of the property.*/
    virtual void setValue(const QVariant &value, bool rememberOldValue = true);
    
private:
    MultiProperty *m_parent;
    ChildPropertyType m_childType;
};

}

#endif