En esta página

Falta una propiedad

qmllint denomina esta categoría de advertencia « [missing-property] ».

No se puede asignar a una propiedad por defecto inexistente

¿Qué ha pasado?

Has asignado un objeto a una propiedad por defecto que no existe.

¿Por qué es un error?

El motor de QML no puede asignar este objeto en tiempo de ejecución.

Ejemplo

import QtQuick

Item {
    component MyType: QtObject { property Item myItem; }

    MyType {
        Item {}
    }
}

Para solucionar esta advertencia, especifica la propiedad a la que quieres vincularlo o, si eres el autor del tipo, marca una propiedad como predeterminada:

import QtQuick

Item {
    component MyType: QtObject { property Item myItem; }

    MyType {
        myItem: Item {}
    }

    component AlternativeMyType: QtObject { default property Item myItem; }

    AlternativeMyType {
        Item {} // bound to myItem via default property
    }
}

La propiedad no existe

¿Qué ha pasado?

Has asignado una expresión a una propiedad que no existe.

¿Por qué es un error?

El motor QML no puede asignar esta expresión en tiempo de ejecución.

Ejemplo

import QtQuick

Item {
    property int myInt
    myItn: 42
}

Para solucionar esta advertencia, elimina el enlace o corrige cualquier posible error tipográfico:

import QtQuick

Item {
    property int myInt
    myInt: 42
}

Miembro no encontrado en el tipo

¿Qué ha pasado?

Has accedido a un miembro en una expresión de miembro de campo que las herramientas de QML no pueden encontrar. Una expresión de miembro de campo es una expresión de la forma someId.someProperty.

Es posible que el miembro no exista en absoluto, por ejemplo, si has cometido un error tipográfico. O bien, puede que exista en tiempo de ejecución (porque existe en un subtipo específico que siempre está presente), pero no en el tipo declarado estáticamente.

¿Por qué es un problema?

Las herramientas de QML no pueden encontrar este miembro, lo que significa que funciones como «ir a la definición» y el autocompletado no funcionarán. En tiempo de ejecución, podría producirse un error o se podría obtener un resultado incorrecto si el miembro realmente no existe. No habrá error si el miembro existe siempre en tiempo de ejecución; sin embargo, en ese caso, aún puede haber un coste de rendimiento debido a optimizaciones no aplicadas.

Ejemplo

La propiedad no existe realmente

import QtQuick

Item {
    id: self
    property int myInt
    property int myInt2: 1 + self.myItn
}

Para solucionar esta advertencia, elimina el enlace o corrige un posible error tipográfico:

import QtQuick

Item {
    id: self
    property int myInt
    property int myInt2: 1 + self.myInt
}

La propiedad existe, pero el tipo no es lo suficientemente preciso

import QtQuick
import QtQuick.Controls.Basic

Item {
  component Message : Item {
    required property string sender
    required property string text
  }
  ListView {
    id: messageView
    delegate: Message {}
  }

  Button {
    text: "Reply to %1".arg(messageView.currentItem.sender) // not ok
  }
}

Para solucionar esta advertencia, convierte el objeto del que has leído datos a un tipo más específico:

import QtQuick
import QtQuick.Controls.Basic

Item {
  component Message : Item {
    required property string sender
    required property string text
  }
  ListView {
    id: messageView
    delegate: Message {}
  }

  Button {
    text: "Reply to %1".arg((messageView.currentItem as Message).sender) // now ok
  }
}

En el ejemplo, el tipo declarado de la propiedad ` currentItem ` de ` messageView` es ` Item`, que no tiene la propiedad ` sender `: ` sender ` solo se define en ` Message`. Sin embargo, sabemos que ` currentItem ` siempre contiene un ` Message`, por lo que podemos convertir ` currentItem ` a ` Message ` utilizando una aserción de tipo.

© 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.