1 /****************************************************************************

     2 **

     3 ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).

     4 ** All rights reserved.

     5 ** Contact: Nokia Corporation (qt-info@nokia.com)

     6 **

     7 ** This file is part of the QtDeclarative module of the Qt Toolkit.

     8 **

     9 ** $QT_BEGIN_LICENSE:LGPL$

    10 ** No Commercial Usage

    11 ** This file contains pre-release code and may not be distributed.

    12 ** You may use this file in accordance with the terms and conditions

    13 ** contained in the Technology Preview License Agreement accompanying

    14 ** this package.

    15 **

    16 ** GNU Lesser General Public License Usage

    17 ** Alternatively, this file may be used under the terms of the GNU Lesser

    18 ** General Public License version 2.1 as published by the Free Software

    19 ** Foundation and appearing in the file LICENSE.LGPL included in the

    20 ** packaging of this file.  Please review the following information to

    21 ** ensure the GNU Lesser General Public License version 2.1 requirements

    22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

    23 **

    24 ** In addition, as a special exception, Nokia gives you certain additional

    25 ** rights.  These rights are described in the Nokia Qt LGPL Exception

    26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

    27 **

    28 ** If you have questions regarding the use of this file, please contact

    29 ** Nokia at qt-info@nokia.com.

    30 **

    31 **

    32 **

    33 **

    34 **

    35 **

    36 **

    37 **

    38 ** $QT_END_LICENSE$

    39 **

    40 ****************************************************************************/

    41 

    42 #ifndef QDECLARATIVEBINDING_P_H

    43 #define QDECLARATIVEBINDING_P_H

    44 

    45 //

    46 //  W A R N I N G

    47 //  -------------

    48 //

    49 // This file is not part of the Qt API.  It exists purely as an

    50 // implementation detail.  This header file may change from version to

    51 // version without notice, or even be removed.

    52 //

    53 // We mean it.

    54 //

    55 

    56 #include "qdeclarative.h"

    57 #include "qdeclarativepropertyvaluesource.h"

    58 #include "qdeclarativeexpression.h"

    59 #include "qdeclarativeproperty.h"

    60 #include "private/qdeclarativeproperty_p.h"

    61 

    62 #include <QtCore/QObject>

    63 #include <QtCore/QMetaProperty>

    64 

    65 QT_BEGIN_NAMESPACE

    66 

    67 class Q_DECLARATIVE_EXPORT QDeclarativeAbstractBinding

    68 {

    69 public:

    70     QDeclarativeAbstractBinding();

    71 

    72     virtual void destroy();

    73 

    74     virtual QString expression() const;

    75 

    76     enum Type { PropertyBinding, ValueTypeProxy };

    77     virtual Type bindingType() const { return PropertyBinding; }

    78 

    79     void setEnabled(bool e) { setEnabled(e, QDeclarativePropertyPrivate::DontRemoveBinding); }

    80     virtual void setEnabled(bool, QDeclarativePropertyPrivate::WriteFlags) = 0;

    81     virtual int propertyIndex() = 0;

    82 

    83     void update() { update(QDeclarativePropertyPrivate::DontRemoveBinding); }

    84     virtual void update(QDeclarativePropertyPrivate::WriteFlags) = 0;

    85 

    86     void addToObject(QObject *);

    87     void removeFromObject();

    88 

    89 protected:

    90     virtual ~QDeclarativeAbstractBinding();

    91     void clear();

    92 

    93 private:

    94 

    95     friend class QDeclarativeData;

    96     friend class QDeclarativeValueTypeProxyBinding;

    97     friend class QDeclarativePropertyPrivate;

    98     friend class QDeclarativeVME;

    99 

   100     QObject *m_object;

   101     QDeclarativeAbstractBinding **m_mePtr;

   102     QDeclarativeAbstractBinding **m_prevBinding;

   103     QDeclarativeAbstractBinding  *m_nextBinding;

   104 };

   105 

   106 class QDeclarativeValueTypeProxyBinding : public QDeclarativeAbstractBinding

   107 {

   108 public:

   109     QDeclarativeValueTypeProxyBinding(QObject *o, int coreIndex);

   110 

   111     virtual Type bindingType() const { return ValueTypeProxy; }

   112 

   113     virtual void setEnabled(bool, QDeclarativePropertyPrivate::WriteFlags);

   114     virtual int propertyIndex();

   115     virtual void update(QDeclarativePropertyPrivate::WriteFlags);

   116 

   117     QDeclarativeAbstractBinding *binding(int propertyIndex);

   118 

   119 protected:

   120     ~QDeclarativeValueTypeProxyBinding();

   121 

   122 private:

   123     void recursiveEnable(QDeclarativeAbstractBinding *, QDeclarativePropertyPrivate::WriteFlags);

   124     void recursiveDisable(QDeclarativeAbstractBinding *);

   125 

   126     friend class QDeclarativeAbstractBinding;

   127     QObject *m_object;

   128     int m_index;

   129     QDeclarativeAbstractBinding *m_bindings;

   130 };

   131 

   132 class QDeclarativeContext;

   133 class QDeclarativeBindingPrivate;

   134 class Q_DECLARATIVE_EXPORT QDeclarativeBinding : public QDeclarativeExpression, public QDeclarativeAbstractBinding

   135 {

   136 Q_OBJECT

   137 public:

   138     QDeclarativeBinding(const QString &, QObject *, QDeclarativeContext *, QObject *parent=0);

   139     QDeclarativeBinding(const QString &, QObject *, QDeclarativeContextData *, QObject *parent=0);

   140     QDeclarativeBinding(void *, QDeclarativeRefCount *, QObject *, QDeclarativeContextData *, 

   141                         const QString &, int, QObject *parent);

   142 

   143     void setTarget(const QDeclarativeProperty &);

   144     QDeclarativeProperty property() const;

   145 

   146     bool enabled() const;

   147 

   148     // Inherited from  QDeclarativeAbstractBinding

   149     virtual void setEnabled(bool, QDeclarativePropertyPrivate::WriteFlags flags);

   150     virtual int propertyIndex();

   151     virtual void update(QDeclarativePropertyPrivate::WriteFlags flags);

   152     virtual QString expression() const;

   153 

   154 public Q_SLOTS:

   155     void update() { update(QDeclarativePropertyPrivate::DontRemoveBinding); }

   156 

   157 protected:

   158     ~QDeclarativeBinding();

   159     void emitValueChanged();

   160 

   161 private:

   162     Q_DECLARE_PRIVATE(QDeclarativeBinding)

   163 };

   164 

   165 QT_END_NAMESPACE

   166 

   167 Q_DECLARE_METATYPE(QDeclarativeBinding*)

   168 

   169 #endif // QDECLARATIVEBINDING_P_H