Merge branch 'master' of git://gitorious.org/qt/qtdeclarative into api_changes
[profile/ivi/qtdeclarative.git] / src / qml / qml / qqmlglobal_p.h
1 /****************************************************************************
2 **
3 ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
4 ** Contact: http://www.qt-project.org/
5 **
6 ** This file is part of the QtQml module of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL$
9 ** GNU Lesser General Public License Usage
10 ** This file may be used under the terms of the GNU Lesser General Public
11 ** License version 2.1 as published by the Free Software Foundation and
12 ** appearing in the file LICENSE.LGPL included in the packaging of this
13 ** file. Please review the following information to ensure the GNU Lesser
14 ** General Public License version 2.1 requirements will be met:
15 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
16 **
17 ** In addition, as a special exception, Nokia gives you certain additional
18 ** rights. These rights are described in the Nokia Qt LGPL Exception
19 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
20 **
21 ** GNU General Public License Usage
22 ** Alternatively, this file may be used under the terms of the GNU General
23 ** Public License version 3.0 as published by the Free Software Foundation
24 ** and appearing in the file LICENSE.GPL included in the packaging of this
25 ** file. Please review the following information to ensure the GNU General
26 ** Public License version 3.0 requirements will be met:
27 ** http://www.gnu.org/copyleft/gpl.html.
28 **
29 ** Other Usage
30 ** Alternatively, this file may be used in accordance with the terms and
31 ** conditions contained in a signed written agreement between you and Nokia.
32 **
33 **
34 **
35 **
36 **
37 **
38 ** $QT_END_LICENSE$
39 **
40 ****************************************************************************/
41
42 #ifndef QQMLGLOBAL_H
43 #define QQMLGLOBAL_H
44
45 #include <QtCore/qglobal.h>
46 #include <QtCore/QObject>
47
48 QT_BEGIN_HEADER
49
50 QT_BEGIN_NAMESPACE
51
52
53 #define DEFINE_BOOL_CONFIG_OPTION(name, var) \
54     static bool name() \
55     { \
56         static enum { Yes, No, Unknown } status = Unknown; \
57         if (status == Unknown) { \
58             QByteArray v = qgetenv(#var); \
59             bool value = !v.isEmpty() && v != "0" && v != "false"; \
60             if (value) status = Yes; \
61             else status = No; \
62         } \
63         return status == Yes; \
64     }
65
66 #define FAST_CONNECT(Sender, Signal, Receiver, Method) \
67 { \
68     QObject *sender = (Sender); \
69     QObject *receiver = (Receiver); \
70     const char *signal = (Signal); \
71     const char *method = (Method); \
72     static int signalIdx = -1; \
73     static int methodIdx = -1; \
74     if (signalIdx < 0) { \
75         if (((int)(*signal) - '0') == QSIGNAL_CODE) \
76             signalIdx = sender->metaObject()->indexOfSignal(signal+1); \
77         else \
78             qWarning("FAST_CONNECT: Invalid signal %s. Please make sure you are using the SIGNAL macro.", signal); \
79     } \
80     if (methodIdx < 0) { \
81         int code = ((int)(*method) - '0'); \
82         if (code == QSLOT_CODE) \
83             methodIdx = receiver->metaObject()->indexOfSlot(method+1); \
84         else if (code == QSIGNAL_CODE) \
85             methodIdx = receiver->metaObject()->indexOfSignal(method+1); \
86         else \
87             qWarning("FAST_CONNECT: Invalid method %s. Please make sure you are using the SIGNAL or SLOT macro.", method); \
88     } \
89     QMetaObject::connect(sender, signalIdx, receiver, methodIdx, Qt::DirectConnection); \
90 }
91
92 struct QQmlGraphics_DerivedObject : public QObject
93 {
94     void setParent_noEvent(QObject *parent) {
95         bool sce = d_ptr->sendChildEvents;
96         d_ptr->sendChildEvents = false;
97         setParent(parent);
98         d_ptr->sendChildEvents = sce;
99     }
100 };
101
102 /*!
103     Returns true if the case of \a fileName is equivalent to the file case of 
104     \a fileName on disk, and false otherwise.
105
106     This is used to ensure that the behavior of QML on a case-insensitive file 
107     system is the same as on a case-sensitive file system.  This function 
108     performs a "best effort" attempt to determine the real case of the file. 
109     It may have false positives (say the case is correct when it isn't), but it
110     should never have a false negative (say the case is incorrect when it is 
111     correct).
112 */
113 bool QQml_isFileCaseCorrect(const QString &fileName);
114
115 /*!
116     Makes the \a object a child of \a parent.  Note that when using this method,
117     neither \a parent nor the object's previous parent (if it had one) will
118     receive ChildRemoved or ChildAdded events.
119 */
120 inline void QQml_setParent_noEvent(QObject *object, QObject *parent)
121 {
122     static_cast<QQmlGraphics_DerivedObject *>(object)->setParent_noEvent(parent);
123 }
124
125 QT_END_NAMESPACE
126
127 QT_END_HEADER
128
129 #endif // QQMLGLOBAL_H