En esta página

QQmlError Class

La clase QQmlError encapsula un error QML. Más...

Cabecera: #include <QQmlError>
CMake: find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)
qmake: QT += qml

Funciones públicas

QQmlError()
QQmlError(const QQmlError &other)
int column() const
QString description() const
bool isValid() const
int line() const
QtMsgType messageType() const
QObject *object() const
void setColumn(int column)
void setDescription(const QString &description)
void setLine(int line)
void setMessageType(QtMsgType messageType)
void setObject(QObject *object)
void setUrl(const QUrl &url)
QString toString() const
QUrl url() const
QQmlError &operator=(const QQmlError &other)
QDebug operator<<(QDebug debug, const QQmlError &error)

Descripción detallada

QQmlError incluye una descripción textual del error, así como información de localización (el archivo, la línea y la columna). El método toString() crea una cadena de una sola línea, legible por humanos, que contiene toda esta información, por ejemplo:

file:///home/user/test.qml:7:8: Invalid property assignment: double expected

Puede utilizar qDebug(), qInfo(), o qWarning() para mostrar los errores en la consola. Este método intentará abrir el archivo indicado por el error e incluir información contextual adicional.

file:///home/user/test.qml:7:8: Invalid property assignment: double expected
        y: "hello"
           ^

Véase también QQuickView::errors() y QQmlComponent::errors().

Documentación de las funciones miembro

QQmlError::QQmlError()

Crea un objeto de error vacío.

QQmlError::QQmlError(const QQmlError &other)

Crea una copia de other.

int QQmlError::column() const

Devuelve el número de columna del error.

Véase también setColumn().

QString QQmlError::description() const

Devuelve la descripción del error.

Véase también setDescription().

bool QQmlError::isValid() const

Devuelve true si este error es válido, en caso contrario false.

int QQmlError::line() const

Devuelve el número de línea de error.

Véase también setLine().

QtMsgType QQmlError::messageType() const

Devuelve el tipo de mensaje.

Véase también setMessageType().

QObject *QQmlError::object() const

Devuelve el objeto más cercano en el que se ha producido este error. Las excepciones en expresiones de propiedades vinculadas establecen este valor en el objeto al que pertenece la propiedad. Será 0 para todas las demás excepciones.

Véase también setObject().

void QQmlError::setColumn(int column)

Establece el número de error column.

Véase también column().

void QQmlError::setDescription(const QString &description)

Establece el error description.

Véase también description().

void QQmlError::setLine(int line)

Establece el número de error line.

Véase también line().

void QQmlError::setMessageType(QtMsgType messageType)

Establece el messageType para este mensaje. El tipo de mensaje determina qué gestores de QDebug son responsables de recibir el mensaje.

Véase también messageType().

void QQmlError::setObject(QObject *object)

Establece el object más cercano donde se produjo este error.

Véase también object().

void QQmlError::setUrl(const QUrl &url)

Establece el url para el archivo que causó este error.

Véase también url().

QString QQmlError::toString() const

Devuelve el error como una cadena legible.

QUrl QQmlError::url() const

Devuelve la url del fichero que ha causado este error.

Véase también setUrl().

QQmlError &QQmlError::operator=(const QQmlError &other)

Asigna other a este objeto de error.

No miembros relacionados

QDebug operator<<(QDebug debug, const QQmlError &error)

Envía una versión legible de error a debug.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.