Sur cette page

QQmlError Class

La classe QQmlError encapsule une erreur QML. En savoir plus...

En-tête : #include <QQmlError>
CMake : find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)
qmake : QT += qml

Fonctions publiques

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)

Description détaillée

QQmlError contient une description textuelle de l'erreur, ainsi que des informations de localisation (fichier, ligne et colonne). La méthode toString() crée une chaîne de caractères lisible par l'utilisateur, sur une seule ligne, contenant toutes ces informations, par exemple :

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

Vous pouvez utiliser qDebug(), qInfo() ou qWarning() pour afficher les erreurs sur la console. Cette méthode tentera d’ouvrir le fichier indiqué par l’erreur et inclura des informations contextuelles supplémentaires.

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

Voir également QQuickView::errors() et QQmlComponent::errors().

Documentation des fonctions membres

QQmlError::QQmlError()

Crée un objet d'erreur vide.

QQmlError::QQmlError(const QQmlError &other)

Crée une copie de other.

int QQmlError::column() const

Renvoie le numéro de la colonne d'erreur.

Voir également setColumn().

QString QQmlError::description() const

Renvoie la description de l'erreur.

Voir aussi setDescription().

bool QQmlError::isValid() const

Renvoie « true » si cette erreur est valide, sinon « false ».

int QQmlError::line() const

Renvoie le numéro de ligne de l'erreur.

Voir aussi setLine().

QtMsgType QQmlError::messageType() const

Renvoie le type du message.

Voir aussi setMessageType().

QObject *QQmlError::object() const

Renvoie l'objet le plus proche où cette erreur s'est produite. Les exceptions survenant dans des expressions de propriété liées attribuent à cette propriété la valeur de l'objet auquel la propriété appartient. Elle sera égale à 0 pour toutes les autres exceptions.

Voir également setObject().

void QQmlError::setColumn(int column)

Définit le numéro d'column s d'erreur.

Voir aussi column().

void QQmlError::setDescription(const QString &description)

Définit l'description d'erreur.

Voir également description().

void QQmlError::setLine(int line)

Définit le numéro d'line s d'erreur.

Voir aussi line().

void QQmlError::setMessageType(QtMsgType messageType)

Définit l'messageType de ce message. Le type de message détermine quels gestionnaires d'QDebug s sont chargés de recevoir le message.

Voir également messageType().

void QQmlError::setObject(QObject *object)

Définit l'object la plus proche où cette erreur s'est produite.

Voir aussi object().

void QQmlError::setUrl(const QUrl &url)

Définit l'url du fichier à l'origine de cette erreur.

Voir aussi url().

QString QQmlError::toString() const

Renvoie l'erreur sous forme de chaîne de caractères lisible par l'utilisateur.

QUrl QQmlError::url() const

Renvoie l'URL du fichier à l'origine de cette erreur.

Voir aussi setUrl().

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

Attribue la valeur « other » à cet objet d'erreur.

Éléments non membres associés

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

Affiche une version lisible par l'utilisateur de error sur 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.