Component QML Type

Der Fortschritt beim Laden der Komponente, von 0.0 (nichts geladen) bis 1.0 (fertig).

Diese Eigenschaft enthält den Status des Komponentenladens. Der Status kann einer der folgenden sein:

Die URL der Komponente. Dies ist die URL, die zur Erstellung der Komponente verwendet wurde.

Wird ausgesendet, nachdem das Objekt instanziiert wurde. Dies kann verwendet werden, um Skriptcode beim Start auszuführen, sobald die vollständige QML-Umgebung eingerichtet ist.

Der onCompleted signal handler kann auf jedem Objekt deklariert werden. Die Reihenfolge, in der die Handler ausgeführt werden, ist undefiniert.

Rectangle {
    Component.onCompleted: console.log("Completed Running!")
    Rectangle {
        Component.onCompleted: console.log("Nested Completed Running!")
    }
}

Wird ausgegeben, wenn die Zerstörung des Objekts beginnt. Dies kann verwendet werden, um Arbeiten rückgängig zu machen, die als Reaktion auf das Signal completed() oder anderen zwingenden Code in Ihrer Anwendung ausgeführt wurden.

Der onDestruction Signalhandler kann für jedes Objekt deklariert werden. Die Reihenfolge, in der die Handler ausgeführt werden, ist undefiniert.

Rectangle {
    Component.onDestruction: console.log("Destruction Beginning!")
    Rectangle {
        Component.onDestruction: console.log("Nested Destruction Beginning!")
    }
}

Siehe auch Qt Qml.

Erzeugt und gibt eine Objektinstanz dieser Komponente zurück, die die angegebenen parent und properties hat. Das Argument properties ist optional. Gibt null zurück, wenn die Objekterstellung fehlschlägt.

Das Objekt wird in demselben Kontext erstellt, in dem die Komponente erstellt wurde. Diese Funktion gibt immer null zurück, wenn sie für Komponenten aufgerufen wird, die nicht in QML erstellt wurden.

Wenn Sie ein Objekt erstellen möchten, ohne ein Elternteil zu setzen, geben Sie null für den Wert parent an. Beachten Sie, dass Sie, wenn das zurückgegebene Objekt angezeigt werden soll, einen gültigen parent Wert angeben oder die parent Eigenschaft des zurückgegebenen Objekts setzen müssen, da das Objekt sonst nicht sichtbar ist.

Wenn createObject() kein parent übergeben wird, muss ein Verweis auf das zurückgegebene Objekt gehalten werden, damit es nicht vom Garbage Collector zerstört wird. Dies gilt unabhängig davon, ob anschließend Item::parent gesetzt wird, da das Setzen des Item-Elternteils nicht den Besitz des Objekts ändert. Nur der grafische Elternteil wird geändert.

Ab QtQuick 1.1 akzeptiert diese Methode ein optionales properties Argument, das eine Zuordnung von anfänglichen Eigenschaftswerten für das erstellte Objekt angibt. Diese Werte werden angewendet, bevor die Objekterstellung abgeschlossen ist. Dies ist effizienter als das Festlegen von Eigenschaftswerten nach der Objekterzeugung, insbesondere wenn große Mengen von Eigenschaftswerten definiert werden, und ermöglicht auch das Einrichten von Eigenschaftsbindungen (mit Qt.binding), bevor das Objekt erzeugt wird.

Das Argument properties wird als eine Karte von Eigenschaftswertelementen angegeben. Der folgende Code erstellt beispielsweise ein Objekt mit den Anfangswerten x und y von 100 bzw. 100:

const component = Qt.createComponent("Button.qml");
if (component.status === Component.Ready) {
    component.createObject(parent, { x: 100, y: 100 });
}

Dynamisch erstellte Instanzen können mit der Methode destroy() gelöscht werden. Weitere Informationen finden Sie unter Dynamische QML-Objekterstellung aus JavaScript.

Siehe auch incubateObject().

Gibt eine menschenlesbare Beschreibung eines Fehlers zurück.

Die Zeichenkette enthält die Datei, den Ort und die Beschreibung jedes Fehlers. Wenn mehrere Fehler vorhanden sind, werden sie durch einen Zeilenumbruch getrennt.

Wenn keine Fehler vorhanden sind, wird eine leere Zeichenfolge zurückgegeben.

Erzeugt einen Inkubator für eine Instanz dieser Komponente. Inkubatoren ermöglichen die asynchrone Instanzierung neuer Komponenteninstanzen und führen nicht zum Einfrieren der Benutzeroberfläche.

Das Argument parent gibt den Elternteil an, den die erstellte Instanz haben wird. Wird der Parameter weggelassen oder null übergeben, wird ein Objekt ohne Elternteil erstellt. In diesem Fall muss ein Verweis auf das erstellte Objekt gehalten werden, damit es nicht durch den Garbage Collector zerstört wird.

Das Argument properties wird als eine Map von Property-Value-Elementen angegeben, die für das erstellte Objekt während seiner Erstellung festgelegt werden. mode kann Qt.Synchronous oder Qt.Asynchronous sein und steuert, ob die Instanz synchron oder asynchron erstellt wird. Die Voreinstellung ist asynchron. Unter bestimmten Umständen kann der Inkubator das Objekt asynchron erstellen, auch wenn Qt.Synchronous angegeben ist. Dies geschieht, wenn die Komponente, die incubateObject() aufruft, selbst asynchron erstellt wird.

Alle drei Argumente sind optional.

Bei Erfolg gibt die Methode einen Inkubator zurück, andernfalls null. Der Inkubator hat die folgenden Eigenschaften:

• status - Der Status des Inkubators. Gültige Werte sind Component.Ready, Component.Loading und Component.Error.
• object - Die erstellte Objektinstanz. Ist nur verfügbar, wenn der Inkubator den Status Ready hat.
• onStatusChanged - Gibt eine Callback-Funktion an, die aufgerufen wird, wenn sich der Status ändert. Der Status wird als Parameter an den Callback übergeben.
• forceCompletion() - Aufruf, um die Inkubation synchron zu beenden.

Das folgende Beispiel zeigt, wie ein Inkubator verwendet wird:

const component = Qt.createComponent("Button.qml");

const incubator = component.incubateObject(parent, { x: 10, y: 10 });
if (incubator.status !== Component.Ready) {
    incubator.onStatusChanged = function(status) {
        if (status === Component.Ready) {
            print("Object", incubator.object, "is now ready!");
        }
    };
} else {
    print("Object", incubator.object, "is ready immediately!");
}

Dynamisch erstellte Instanzen können mit der Methode destroy() gelöscht werden. Weitere Informationen finden Sie unter Dynamische QML-Objekterzeugung aus JavaScript.

Siehe auch createObject().