Drag QML Type

Diese Eigenschaft gibt an, ob eine Drag-Ereignissequenz gerade aktiv ist.

Die Bindung dieser Eigenschaft an die aktive Eigenschaft von MouseArea::drag bewirkt, dass startDrag aufgerufen wird, wenn der Benutzer mit dem Ziehen beginnt.

Wird diese Eigenschaft auf true gesetzt, wird auch ein QDragEnter-Ereignis mit der aktuellen Position des Elements an die Szene gesendet. Wird sie auf false gesetzt, wird ein QDragLeave-Ereignis gesendet.

Während des Ziehens wird bei jeder Änderung der Position des Objekts ein QDragMove-Ereignis mit der neuen Position des Objekts an die Szene gesendet.

Diese Eigenschaft gibt an, ob Ziehvorgänge automatisch gestartet werden sollen, ob nichts getan werden soll oder ob abwärtskompatible interne Ziehvorgänge verwendet werden sollen. Die Voreinstellung ist, abwärtskompatible interne Drags zu verwenden.

Ein Drag kann auch manuell mit startDrag gestartet werden.

Wenn Sie Drag.Automatic verwenden, sollten Sie auch mimeData definieren und die Eigenschaft active an die aktive Eigenschaft von MouseArea binden: MouseArea::drag.active

Diese Eigenschaft enthält die Ziehposition relativ zur linken oberen Ecke des Elements.

Standardmäßig ist dies (0, 0).

Änderungen am HotSpot lösen eine neue Ziehbewegung mit der aktualisierten Position aus.

Diese Eigenschaft enthält die URL des Bildes, das zur Darstellung der Daten beim Ziehen und Ablegen verwendet wird. Eine Änderung dieser Eigenschaft nach Beginn des Ziehvorgangs hat keine Auswirkung.

Im folgenden Beispiel wird der Inhalt eines Elements als Ziehbild verwendet:

import QtQuick

Item {
    width: 200; height: 200

    Rectangle {
        anchors.centerIn: parent
        width: text.implicitWidth + 20; height: text.implicitHeight + 10
        color: "green"
        radius: 5

        Drag.dragType: Drag.Automatic
        Drag.supportedActions: Qt.CopyAction
        Drag.mimeData: {
            "text/plain": "Copied text"
        }

        Text {
            id: text
            anchors.centerIn: parent
            text: "Drag me"
        }

        DragHandler {
            id: dragHandler
            onActiveChanged:
                if (active) {
                    parent.grabToImage(function(result) {
                        parent.Drag.imageSource = result.url
                        parent.Drag.active = true
                    })
                } else {
                    parent.Drag.active = false
                }
        }
    }
}

Siehe auch Item::grabToImage().

Diese Eigenschaft gibt die Größe des Bildes an, das zur Darstellung der Daten während des Ziehen-und-Ablegen-Vorgangs verwendet wird. Das Ändern dieser Eigenschaft nach dem Start des Ziehvorgangs hat keine Auswirkungen mehr.

Diese Eigenschaft legt die maximale Anzahl von Pixeln fest, die für das geladene Bild gespeichert werden, damit große Bilder nicht mehr Speicher als nötig benötigen. Siehe Image.sourceSize für weitere Details.

Das folgende Beispiel zeigt ein SVG-Bild, das in einer bestimmten Größe gerendert wurde und für das Ziehen des Bildes in einer anderen Größe neu gerendert wird:

import QtQuick

Item {
    width: 200; height: 200

    Image {
        anchors.centerIn: parent
        source: "images/qt_logo.svg"
        sourceSize.width: 96

        Drag.dragType: Drag.Automatic
        Drag.supportedActions: Qt.CopyAction
        Drag.mimeData: {
            "text/plain": "Qt Quick rocks!"
        }
        Drag.imageSource: "images/qt_logo.svg"
        Drag.imageSourceSize: Qt.size(48, 35)
        Drag.active: dragHandler.active

        DragHandler {
            id: dragHandler
        }
    }
}

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Siehe auch imageSource und Item::grabToImage().

Diese Eigenschaft enthält eine Liste von Schlüsseln, die von DropArea verwendet werden können, um Drag-Ereignisse zu filtern.

Das Ändern der Schlüssel während des Ziehens setzt die Reihenfolge der Zieh-Ereignisse zurück, indem ein Zieh-Verlassen-Ereignis gefolgt von einem Zieh-Eingabe-Ereignis mit der neuen Quelle gesendet wird.

Diese Eigenschaft enthält eine Zuordnung von Mime-Typ zu Daten, die während startDrag verwendet werden. Die Mime-Daten müssen von einem Typ sein, der mit dem Mime-Typ übereinstimmt (z. B. eine Zeichenkette, wenn der Mime-Typ "text/plain" ist, oder ein Bild, wenn der Mime-Typ "image/png" ist), oder eine ArrayBuffer mit den Daten, die entsprechend dem Mime-Typ kodiert sind.

Diese Eigenschaft enthält eine Aktion, die von der Drag-Quelle als Rückgabewert von Drag.drop() empfohlen wird.

Änderungen an proposedAction lösen ein Verschiebungsereignis mit dem aktualisierten Vorschlag aus.

Diese Eigenschaft enthält ein Objekt, das den Empfängern von Drag-Ereignissen als die Quelle der Ereignisse angezeigt wird. Standardmäßig ist dies das Element, dem die Eigenschaft Drag zugeordnet ist.

Wenn Sie die Quelle ändern, während ein Ziehen aktiv ist, wird die Abfolge der Ziehereignisse zurückgesetzt, indem ein Ziehverlassen-Ereignis gefolgt von einem Zieheingabe-Ereignis mit der neuen Quelle gesendet wird.

Diese Eigenschaft enthält Rückgabewerte von Drag.drop(), die von der Drag-Quelle unterstützt werden.

Wenn die unterstützten Aktionen bei aktivem Ziehen geändert werden, wird die Abfolge der Ziehereignisse zurückgesetzt, indem ein Ziehverlassen-Ereignis gefolgt von einem Ziehbetreten-Ereignis mit der neuen Quelle gesendet wird.

Wenn das Ziehen aktiv ist, enthält diese Eigenschaft das letzte Objekt, das ein Enter-Ereignis vom gezogenen Element akzeptiert hat; wenn die aktuelle Ziehposition kein akzeptierendes Ziel überschneidet, ist sie null.

Wenn das Ziehen nicht aktiv ist, enthält diese Eigenschaft das Objekt, das das Drop-Ereignis akzeptiert hat, das das Ziehen beendete. Wenn kein Objekt das Drop-Ereignis akzeptiert hat oder das Ziehen abgebrochen wurde, ist das Ziel dann null.

Dieses Signal wird ausgegeben, wenn ein Ziehen beendet wird und das Ziehen mit der Methode startDrag() oder automatisch mit der Eigenschaft dragType gestartet wurde.

dropAction Das Signal enthält die vom Zielelement akzeptierte Aktion.

Siehe auch drop().

Dieses Signal wird ausgegeben, wenn ein Drag mit der Methode startDrag() oder automatisch mit der Eigenschaft dragType gestartet wird.

Beendet eine Drag-Sequenz.

Beendet eine Ziehungssequenz durch Senden eines Drop-Ereignisses an das Zielelement.

Gibt die vom Zielelement akzeptierte Aktion zurück. Wenn das Zielelement oder ein übergeordnetes Element das Drop-Ereignis nicht akzeptiert, wird Qt.IgnoreAction zurückgegeben.

Die zurückgegebene Drop-Aktion kann eine der folgenden sein:

Startet das Senden von Drag-Ereignissen. Wird zum Starten von internen Ziehvorgängen im alten Stil verwendet. startDrag ist die neue, bevorzugte Methode zum Starten von Ziehvorgängen.

Das optionale Argument supportedActions kann verwendet werden, um die Eigenschaft supportedActions für die gestartete Sequenz außer Kraft zu setzen.

Beginnt mit dem Senden von Ziehereignissen.

Das optionale Argument supportedActions kann verwendet werden, um die Eigenschaft supportedActions für die gestartete Sequenz zu überschreiben.