En esta página

QQmlError Class

La clase QQmlError encapsula un error de QML. Más información...

Encabezado: #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 sobre su ubicación (el archivo, la línea y la columna). El método toString() crea una cadena de una sola línea, legible para el usuario, que contiene toda esta información; por ejemplo:

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

Puedes 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 de 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 la columna de 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, devuelve «false».

int QQmlError::line() const

Devuelve el número de línea del 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 produjo este error. Las excepciones en expresiones de propiedades vinculadas establecen este valor como 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é controladores de « QDebug » se encargan 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 la propiedad « url » del archivo que ha provocado este error.

Véase también url().

QString QQmlError::toString() const

Devuelve el error como una cadena legible para el usuario.

QUrl QQmlError::url() const

Devuelve la URL del archivo que ha provocado este error.

Véase también setUrl().

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

Asigna ` other ` a este objeto de error.

Elementos no miembros relacionados

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

Genera una versión legible para el usuario de error y la envía 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.