1 /****************************************************************************
3 ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
4 ** All rights reserved.
5 ** Contact: Nokia Corporation (qt-info@nokia.com)
7 ** This file is part of the QtDeclarative module of the Qt Toolkit.
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
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.
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.
28 ** If you have questions regarding the use of this file, please contact
29 ** Nokia at qt-info@nokia.com.
40 ****************************************************************************/
42 #include "qdeclarativeinfo.h"
44 #include "private/qdeclarativedata_p.h"
45 #include "qdeclarativecontext.h"
46 #include "private/qdeclarativecontext_p.h"
47 #include "private/qdeclarativemetatype_p.h"
48 #include "private/qdeclarativeengine_p.h"
50 #include <QCoreApplication>
55 \fn QDeclarativeInfo qmlInfo(const QObject *object)
56 \relates QDeclarativeEngine
58 Prints warning messages that include the file and line number for the
59 specified QML \a object.
61 When QML types display warning messages, it improves traceability
62 if they include the QML file and line number on which the
63 particular instance was instantiated.
65 To include the file and line number, an object must be passed. If
66 the file and line number is not available for that instance
67 (either it was not instantiated by the QML engine or location
68 information is disabled), "unknown location" will be used instead.
73 qmlInfo(object) << tr("component property is a write-once property");
79 QML MyCustomType (unknown location): component property is a write-once property
83 class QDeclarativeInfoPrivate
86 QDeclarativeInfoPrivate() : ref (1), object(0) {}
89 const QObject *object;
91 QList<QDeclarativeError> errors;
94 QDeclarativeInfo::QDeclarativeInfo(QDeclarativeInfoPrivate *p)
95 : QDebug(&p->buffer), d(p)
100 QDeclarativeInfo::QDeclarativeInfo(const QDeclarativeInfo &other)
101 : QDebug(other), d(other.d)
106 QDeclarativeInfo::~QDeclarativeInfo()
109 QList<QDeclarativeError> errors = d->errors;
111 QDeclarativeEngine *engine = 0;
113 if (!d->buffer.isEmpty()) {
114 QDeclarativeError error;
116 QObject *object = const_cast<QObject *>(d->object);
119 engine = qmlEngine(d->object);
121 QDeclarativeType *type = QDeclarativeMetaType::qmlType(object->metaObject());
123 typeName = QLatin1String(type->qmlTypeName());
124 int lastSlash = typeName.lastIndexOf(QLatin1Char('/'));
126 typeName = typeName.mid(lastSlash+1);
128 typeName = QString::fromUtf8(object->metaObject()->className());
129 int marker = typeName.indexOf(QLatin1String("_QMLTYPE_"));
131 typeName = typeName.left(marker);
133 marker = typeName.indexOf(QLatin1String("_QML_"));
135 typeName = typeName.left(marker) + "*";
136 type = QDeclarativeMetaType::qmlType(QMetaType::type(typeName.toLatin1()));
138 typeName = QLatin1String(type->qmlTypeName());
139 int lastSlash = typeName.lastIndexOf(QLatin1Char('/'));
141 typeName = typeName.mid(lastSlash+1);
146 d->buffer.prepend(QLatin1String("QML ") + typeName + QLatin1String(": "));
148 QDeclarativeData *ddata = QDeclarativeData::get(object, false);
149 if (ddata && ddata->outerContext && !ddata->outerContext->url.isEmpty()) {
150 error.setUrl(ddata->outerContext->url);
151 error.setLine(ddata->lineNumber);
152 error.setColumn(ddata->columnNumber);
156 error.setDescription(d->buffer);
158 errors.prepend(error);
161 QDeclarativeEnginePrivate::warning(engine, errors);
167 QDeclarativeInfo qmlInfo(const QObject *me)
169 QDeclarativeInfoPrivate *d = new QDeclarativeInfoPrivate;
171 return QDeclarativeInfo(d);
174 QDeclarativeInfo qmlInfo(const QObject *me, const QDeclarativeError &error)
176 QDeclarativeInfoPrivate *d = new QDeclarativeInfoPrivate;
179 return QDeclarativeInfo(d);
182 QDeclarativeInfo qmlInfo(const QObject *me, const QList<QDeclarativeError> &errors)
184 QDeclarativeInfoPrivate *d = new QDeclarativeInfoPrivate;
187 return QDeclarativeInfo(d);