QQuickItem Class

Member Function Dokumentation

[explicit] QQuickItem::QQuickItem(QQuickItem *parent = nullptr)

Konstruiert ein QQuickItem mit dem angegebenen parent.

parent wird sowohl als visual parent als auch als QObject Elternteil verwendet.

[override virtual noexcept] QQuickItem::~QQuickItem()

Zerstört die QQuickItem.

bool QQuickItem::acceptHoverEvents() const

Gibt zurück, ob Hover-Ereignisse von diesem Element akzeptiert werden.

Der Standardwert ist false.

Wenn dieser Wert false ist, empfängt das Element keine Hover-Ereignisse über die Funktionen hoverEnterEvent(), hoverMoveEvent() und hoverLeaveEvent().

Siehe auch setAcceptHoverEvents().

bool QQuickItem::acceptTouchEvents() const

Gibt zurück, ob Berührungsereignisse von diesem Element akzeptiert werden.

Der Standardwert ist false.

Wenn dieser Wert false ist, empfängt das Element keine Berührungsereignisse über die Funktion touchEvent().

Siehe auch setAcceptTouchEvents().

Qt::MouseButtons QQuickItem::acceptedMouseButtons() const

Gibt die von diesem Element akzeptierten Maustasten zurück.

Der Standardwert ist Qt::NoButton; das heißt, es werden keine Maustasten akzeptiert.

Wenn ein Element die Maustaste für ein bestimmtes Mausereignis nicht akzeptiert, wird das Mausereignis nicht an das Element geliefert, sondern an das nächste Element in der Elementhierarchie.

Siehe auch setAcceptedMouseButtons() und acceptTouchEvents().

[virtual] QRectF QQuickItem::boundingRect() const

Gibt die Ausdehnung des Elements in seinem eigenen Koordinatensystem zurück: ein Rechteck von 0, 0 bis width() und height().

[invokable] QQuickItem *QQuickItem::childAt(qreal x, qreal y) const

Gibt das erste sichtbare untergeordnete Element zurück, das am Punkt (x, y) innerhalb des Koordinatensystems dieses Elements gefunden wurde.

Gibt nullptr zurück, wenn es kein solches Element gibt.

QList<QQuickItem *> QQuickItem::childItems() const

Gibt die Kinder dieses Elements zurück.

[virtual protected] bool QQuickItem::childMouseEventFilter(QQuickItem *item, QEvent *event)

Reimplementieren Sie diese Methode, um die Zeigerereignisse zu filtern, die von den Kindern dieses Elements empfangen werden.

Diese Methode wird nur aufgerufen, wenn filtersChildMouseEvents() true ist.

Geben Sie true zurück, wenn das angegebene event nicht an das angegebene Kind item weitergegeben werden soll, und andernfalls false. Wenn Sie true zurückgeben, sollten Sie auch accept oder ignore die event zurückgeben, um zu signalisieren, ob die Ereignisausbreitung angehalten oder fortgesetzt werden soll. Die event wird jedoch immer an alle ChildMouseEventFilters in der übergeordneten Kette gesendet.

Siehe auch setFiltersChildMouseEvents().

[override virtual protected] void QQuickItem::classBegin()

Reimplements: QQmlParserStatus::classBegin().

Abgeleitete Klassen sollten die Methode der Basisklasse aufrufen, bevor sie ihre eigene Aktion hinzufügen, die bei classBegin ausgeführt wird.

[virtual] QRectF QQuickItem::clipRect() const

Liefert den rechteckigen Bereich innerhalb dieses Elements, der derzeit in viewportItem() sichtbar ist, wenn ein Ansichtsfenster vorhanden und das Kennzeichen ItemObservesViewport gesetzt ist; andernfalls die Ausmaße dieses Elements in seinem eigenen Koordinatensystem: ein Rechteck von 0, 0 bis width() und height(). Dies ist der Bereich, der sichtbar bleiben soll, wenn clip auf true gesetzt ist. Er kann auch in updatePaintNode() verwendet werden, um die dem Szenengraph hinzugefügten Grafiken zu begrenzen.

Zum Beispiel könnte eine große Zeichnung oder ein großes Textdokument in einem Flickable angezeigt werden, das nur einen Teil des Fensters der Anwendung einnimmt: In diesem Fall ist Flickable das Ansichtsfenster-Element, und ein benutzerdefiniertes Inhaltswiedergabe-Element kann wählen, ob es Szenegrafik-Knoten auslässt, die außerhalb des aktuell sichtbaren Bereichs liegen. Wenn das ItemObservesViewport Flag gesetzt ist, ändert sich dieser Bereich jedes Mal, wenn der Benutzer den Inhalt im Flickable scrollt.

Bei verschachtelten Ansichtsfenstern ist clipRect() die Schnittmenge der boundingRectaller Vorgänger, bei denen das Flag ItemIsViewport gesetzt ist, abgebildet auf das Koordinatensystem dieses Elements.

Siehe auch boundingRect().

[override virtual protected] void QQuickItem::componentComplete()

Reimplements: QQmlParserStatus::componentComplete().

Abgeleitete Klassen sollten die Methode der Basisklasse aufrufen, bevor sie ihre eigenen Aktionen hinzufügen, die bei componentComplete ausgeführt werden.

[virtual invokable] bool QQuickItem::contains(const QPointF &point) const

Gibt true zurück, wenn dieses Element point enthält, das sich in lokalen Koordinaten befindet; andernfalls wird false zurückgegeben.

Diese Funktion kann überschrieben werden, um Punktkollisionen in Elementen mit eigenen Formen zu behandeln. Die Standardimplementierung prüft, ob der Punkt innerhalb von containmentMask() liegt, wenn es gesetzt ist, oder andernfalls innerhalb der Bounding Box.

QCursor QQuickItem::cursor() const

Gibt die Form des Cursors für dieses Element zurück.

Der Mauszeiger nimmt diese Form an, wenn er sich über diesem Element befindet, es sei denn, es wurde ein Override-Cursor festgelegt. Siehe list of predefined cursor objects für eine Reihe von nützlichen Formen.

Wenn keine Cursorform festgelegt wurde, wird ein Cursor mit der Form Qt::ArrowCursor zurückgegeben, jedoch kann eine andere Cursorform angezeigt werden, wenn ein überlappendes Element einen gültigen Cursor hat.

Siehe auch setCursor() und unsetCursor().

[virtual protected] void QQuickItem::dragEnterEvent(QDragEnterEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Drag-Entry-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Drag-and-Drop-Ereignisse werden nur bereitgestellt, wenn das Kennzeichen ItemAcceptsDrops für dieses Element gesetzt wurde.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

Siehe auch Drag und Drag and Drop.

[virtual protected] void QQuickItem::dragLeaveEvent(QDragLeaveEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Drag-Leave-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Drag-and-Drop-Ereignisse werden nur bereitgestellt, wenn das Kennzeichen ItemAcceptsDrops für dieses Element gesetzt wurde.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

Siehe auch Drag und Drag and Drop.

[virtual protected] void QQuickItem::dragMoveEvent(QDragMoveEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Drag-Move-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Drag-and-Drop-Ereignisse werden nur bereitgestellt, wenn das Kennzeichen ItemAcceptsDrops für dieses Element gesetzt wurde.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

Siehe auch Drag und Drag and Drop.

[virtual protected] void QQuickItem::dropEvent(QDropEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Drop-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden über den Parameter event bereitgestellt.

Drag-and-Drop-Ereignisse werden nur bereitgestellt, wenn das Kennzeichen ItemAcceptsDrops für dieses Element gesetzt wurde.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

Siehe auch Drag und Drag and Drop.

[invokable, since 6.3] void QQuickItem::dumpItemTree() const

Gibt einige Details über den visuellen Baum der Elemente aus, die mit diesem Element beginnen, rekursiv.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch Debugging-Techniken und GammaRay's Qt Quick Inspector.

[invokable, since 6.3] void QQuickItem::ensurePolished()

Ruft updatePolish() auf.

Dies kann für Elemente wie Layouts (oder Positionierer) nützlich sein, die die Berechnung ihrer implicitWidth und implicitHeight verzögern, bis sie ein PolishEvent erhalten.

Wenn z. B. ein untergeordnetes Element zu einem Layout hinzugefügt oder entfernt wird, wird die implizite Größe normalerweise nicht sofort berechnet (dies ist eine Optimierung). In einigen Fällen kann es wünschenswert sein, die implizite Größe des Layouts direkt nach dem Hinzufügen eines untergeordneten Elements abzufragen. Ist dies der Fall, verwenden Sie diese Funktion unmittelbar vor der Abfrage der impliziten Größe.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch updatePolish() und polish().

[override virtual protected] bool QQuickItem::event(QEvent *ev)

Reimplements: QObject::event(QEvent *e).

bool QQuickItem::filtersChildMouseEvents() const

Gibt zurück, ob Zeigerereignisse, die für die Kinder dieses Elements bestimmt sind, durch dieses Element gefiltert werden sollen.

Wenn sowohl dieses Element als auch ein untergeordnetes Element über acceptTouchEvents() true verfügen, filtert dieses Element das Berührungsereignis, wenn eine Berührungsinteraktion stattfindet. Wenn jedoch entweder dieses Element oder das untergeordnete Element keine Berührungsereignisse verarbeiten kann, wird childMouseEventFilter() mit einem synthetisierten Mausereignis aufgerufen.

Siehe auch setFiltersChildMouseEvents() und childMouseEventFilter().

QQuickItem::Flags QQuickItem::flags() const

Gibt die Artikelkennzeichen für diesen Artikel zurück.

Siehe auch setFlags() und setFlag().

[virtual protected] void QQuickItem::focusInEvent(QFocusEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Fokus-in-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden über den Parameter event bereitgestellt.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

Wenn Sie diese Funktion neu implementieren, sollten Sie die Implementierung der Basisklasse aufrufen.

[virtual protected] void QQuickItem::focusOutEvent(QFocusEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Focus-Out-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden über den Parameter event bereitgestellt.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

[invokable] void QQuickItem::forceActiveFocus()

Erzwingt den aktiven Fokus auf das Element.

Diese Methode setzt den Fokus auf das Element und stellt sicher, dass alle Vorgängerobjekte FocusScope in der Objekthierarchie auch focus erhalten.

Der Grund für den Fokuswechsel ist Qt::OtherFocusReason. Verwenden Sie die überladene Methode, um den Grund für den Fokuswechsel anzugeben, um eine bessere Handhabung des Fokuswechsels zu ermöglichen.

Siehe auch activeFocus.

[invokable] void QQuickItem::forceActiveFocus(Qt::FocusReason reason)

Dies ist eine überladene Funktion.

Erzwingt den aktiven Fokus auf das Element mit dem angegebenen reason.

Diese Methode setzt den Fokus auf das Element und stellt sicher, dass alle Vorgängerobjekte FocusScope in der Objekthierarchie auch focus erhalten.

Siehe auch activeFocus und Qt::FocusReason.

[virtual protected, since 6.0] void QQuickItem::geometryChange(const QRectF &newGeometry, const QRectF &oldGeometry)

Diese Funktion wird aufgerufen, um die Änderungen der Geometrie dieses Elements von oldGeometry auf newGeometry zu behandeln. Wenn die beiden Geometrien gleich sind, wird nichts unternommen.

Abgeleitete Klassen müssen die Methode der Basisklasse innerhalb ihrer Implementierung aufrufen.

Diese Funktion wurde in Qt 6.0 eingeführt.

QSharedPointer<QQuickItemGrabResult> QQuickItem::grabToImage(const QSize &targetSize = QSize())

Ergreift das Element in ein speicherinternes Bild.

Der Grabvorgang erfolgt asynchron und das Signal QQuickItemGrabResult::ready() wird ausgegeben, wenn der Grabvorgang abgeschlossen ist.

Verwenden Sie targetSize, um die Größe des Zielbildes anzugeben. Standardmäßig hat das Ergebnis die gleiche Größe wie item.

Wenn der Grabvorgang nicht eingeleitet werden konnte, gibt die Funktion null zurück.

Siehe auch QQuickWindow::grabWindow().

[protected] bool QQuickItem::heightValid() const

Gibt zurück, ob die Eigenschaft Höhe explizit festgelegt wurde.

[virtual protected] void QQuickItem::hoverEnterEvent(QHoverEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Hover-Entry-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Hover-Ereignisse werden nur bereitgestellt, wenn acceptHoverEvents() wahr ist.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

[virtual protected] void QQuickItem::hoverLeaveEvent(QHoverEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Hover-Leave-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Hover-Ereignisse werden nur bereitgestellt, wenn acceptHoverEvents() wahr ist.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

[virtual protected] void QQuickItem::hoverMoveEvent(QHoverEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Hover-Move-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Hover-Ereignisse werden nur bereitgestellt, wenn acceptHoverEvents() wahr ist.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

qreal QQuickItem::implicitWidth() const

Gibt die Breite des Elements zurück, die durch andere Eigenschaften, die den Inhalt bestimmen, impliziert wird.

Siehe auch setImplicitWidth().

[virtual protected] void QQuickItem::inputMethodEvent(QInputMethodEvent *event)

Dieser Eventhandler kann in einer Unterklasse neu implementiert werden, um Eingabemethodenereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Das Ereignis wird standardmäßig akzeptiert, so dass es nicht notwendig ist, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

[virtual] QVariant QQuickItem::inputMethodQuery(Qt::InputMethodQuery query) const

Diese Methode ist nur für Eingabeelemente relevant.

Wenn es sich bei diesem Element um ein Eingabeelement handelt, sollte diese Methode neu implementiert werden, um die entsprechenden Eingabemethoden-Flags für das angegebene query zurückzugeben.

Siehe auch QWidget::inputMethodQuery().

bool QQuickItem::isAncestorOf(const QQuickItem *child) const

Gibt true zurück, wenn dieses Element ein Vorfahre von child ist (d. h., wenn dieses Element ein Elternteil von child oder ein Vorfahre eines Elternteils von child ist).

Siehe auch parentItem().

[protected] bool QQuickItem::isComponentComplete() const

Gibt true zurück, wenn die Konstruktion der QML-Komponente abgeschlossen ist; andernfalls wird false zurückgegeben.

Oft ist es wünschenswert, einige Verarbeitungsschritte zu verzögern, bis die Komponente fertiggestellt ist.

Siehe auch componentComplete().

bool QQuickItem::isFocusScope() const

Gibt true zurück, wenn dieses Element ein Fokusbereich ist, andernfalls false.

[virtual] bool QQuickItem::isTextureProvider() const

Gibt true zurück, wenn dieses Element ein Texturanbieter ist. Die Standardimplementierung gibt false zurück.

Diese Funktion kann von jedem Thread aus aufgerufen werden.

[virtual protected] void QQuickItem::itemChange(QQuickItem::ItemChange change, const QQuickItem::ItemChangeData &value)

Wird aufgerufen, wenn change für dieses Element auftritt.

value enthält gegebenenfalls zusätzliche Informationen über die Änderung.

Wenn Sie diese Methode in einer Unterklasse neu implementieren, stellen Sie sicher, dass Sie

QQuickItem::itemChange(change, value);

typischerweise am Ende Ihrer Implementierung aufrufen, um sicherzustellen, dass das Signal windowChanged() ausgegeben wird.

bool QQuickItem::keepMouseGrab() const

Gibt zurück, ob Mauseingaben ausschließlich bei diesem Element verbleiben sollen.

Siehe auch setKeepMouseGrab(), QEvent::accept(), und QEvent::ignore().

bool QQuickItem::keepTouchGrab() const

Gibt zurück, ob die von diesem Element gegriffenen Touchpoints ausschließlich bei diesem Element verbleiben sollen.

Siehe auch setKeepTouchGrab(), keepMouseGrab(), QEvent::accept(), und QEvent::ignore().

[virtual protected] void QQuickItem::keyPressEvent(QKeyEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Tastendruck-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

[virtual protected] void QQuickItem::keyReleaseEvent(QKeyEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Ereignisse zur Freigabe von Tasten für ein Element zu empfangen. Die Ereignisinformationen werden über den Parameter event bereitgestellt.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

[invokable] QPointF QQuickItem::mapFromGlobal(const QPointF &point) const

Bildet den angegebenen point im globalen Bildschirmkoordinatensystem auf den entsprechenden Punkt im Koordinatensystem dieses Elements ab und gibt die abgebildete Koordinate zurück.

Die folgenden Eigenschaften des Objekts werden bei der Zuordnung verwendet: x, y, scale, rotation, transformOrigin, und transform.

Wenn die Elemente Teil verschiedener Szenen sind, enthält die Zuordnung die relative Position der beiden Szenen.

Dies kann zum Beispiel hilfreich sein, um ein Popup zu einer Qt Quick Komponente hinzuzufügen.

Siehe auch Konzepte - Visuelle Koordinaten in Qt Quick.

[invokable] QPointF QQuickItem::mapFromItem(const QQuickItem *item, const QPointF &point) const

Überträgt den angegebenen point im Koordinatensystem von item auf den entsprechenden Punkt im Koordinatensystem dieses Elements und gibt die übertragene Koordinate zurück.

Die folgenden Eigenschaften des Objekts werden bei der Zuordnung verwendet: x, y, scale, rotation, transformOrigin, und transform.

Wenn die Elemente Teil verschiedener Szenen sind, enthält die Zuordnung die relative Position der beiden Szenen.

Wenn item nullptr ist, wird point aus dem Koordinatensystem der Szene abgebildet.

Siehe auch Konzepte - Visuelle Koordinaten in Qt Quick.

QPointF QQuickItem::mapFromScene(const QPointF &point) const

Überträgt den angegebenen point im Koordinatensystem der Szene auf den entsprechenden Punkt im Koordinatensystem dieses Objekts und gibt die übertragene Koordinate zurück.

Die folgenden Eigenschaften des Objekts werden bei der Zuordnung verwendet: x, y, scale, rotation, transformOrigin, und transform.

Wenn die Elemente Teil verschiedener Szenen sind, enthält die Zuordnung die relative Position der beiden Szenen.

Siehe auch Konzepte - Visuelle Koordinaten in Qt Quick.

QRectF QQuickItem::mapRectFromItem(const QQuickItem *item, const QRectF &rect) const

Ordnet das angegebene rect im Koordinatensystem von item der entsprechenden rechteckigen Fläche im Koordinatensystem dieses Elements zu und gibt den Wert des zugeordneten Rechtecks zurück.

Die folgenden Eigenschaften des Elements werden bei der Abbildung verwendet: x, y, scale, rotation, transformOrigin und transform.

Wenn die Elemente Teil verschiedener Szenen sind, enthält die Abbildung die relative Position der beiden Szenen.

Wenn item nullptr ist, wird rect vom Koordinatensystem der Szene aus zugeordnet.

Siehe auch Konzepte - Visuelle Koordinaten in Qt Quick.

QRectF QQuickItem::mapRectFromScene(const QRectF &rect) const

Überträgt das angegebene rect im Koordinatensystem der Szene auf die entsprechende rechteckige Fläche im Koordinatensystem dieses Elements und gibt den Wert des übertragenen Rechtecks zurück.

Die folgenden Eigenschaften des Objekts werden bei der Abbildung verwendet: x, y, scale, rotation, transformOrigin und transform.

Wenn die Elemente Teil verschiedener Szenen sind, enthält die Zuordnung die relative Position der beiden Szenen.

Siehe auch Konzepte - Visuelle Koordinaten in Qt Quick.

QRectF QQuickItem::mapRectToItem(const QQuickItem *item, const QRectF &rect) const

Bildet die angegebene rect im Koordinatensystem dieses Elements auf die entsprechende rechteckige Fläche im Koordinatensystem von item ab und gibt den Wert des abgebildeten Rechtecks zurück.

Die folgenden Eigenschaften des Objekts werden bei der Abbildung verwendet: x, y, scale, rotation, transformOrigin und transform.

Wenn die Elemente Teil verschiedener Szenen sind, enthält die Abbildung die relative Position der beiden Szenen.

Wenn item nullptr ist, wird rect auf das Koordinatensystem der Szene abgebildet.

Siehe auch Konzepte - Visuelle Koordinaten in Qt Quick.

QRectF QQuickItem::mapRectToScene(const QRectF &rect) const

Bildet die angegebene rect im Koordinatensystem dieses Objekts auf die entsprechende rechteckige Fläche im Koordinatensystem der Szene ab und gibt den Wert des abgebildeten Rechtecks zurück.

Die folgenden Eigenschaften des Objekts werden bei der Abbildung verwendet: x, y, scale, rotation, transformOrigin und transform.

Wenn die Elemente Teil verschiedener Szenen sind, enthält die Zuordnung die relative Position der beiden Szenen.

Siehe auch Konzepte - Visuelle Koordinaten in Qt Quick.

[invokable] QPointF QQuickItem::mapToGlobal(const QPointF &point) const

Ordnet den angegebenen Punkt point im Koordinatensystem dieses Elements dem entsprechenden Punkt im globalen Bildschirmkoordinatensystem zu und gibt die zugeordnete Koordinate zurück.

Die folgenden Eigenschaften des Objekts werden bei der Zuordnung verwendet: x, y, scale, rotation, transformOrigin, und transform.

Wenn die Elemente Teil verschiedener Szenen sind, enthält die Zuordnung die relative Position der beiden Szenen.

Dies kann zum Beispiel hilfreich sein, um ein Popup zu einer Qt Quick Komponente hinzuzufügen.

Siehe auch Konzepte - Visuelle Koordinaten in Qt Quick.

[invokable] QPointF QQuickItem::mapToItem(const QQuickItem *item, const QPointF &point) const

Ordnet den angegebenen Punkt point im Koordinatensystem dieses Elements dem entsprechenden Punkt im Koordinatensystem von item zu und gibt die zugeordnete Koordinate zurück.

Die folgenden Eigenschaften des Objekts werden bei der Zuordnung verwendet: x, y, scale, rotation, transformOrigin, und transform.

Wenn die Elemente Teil verschiedener Szenen sind, enthält die Zuordnung die relative Position der beiden Szenen.

Wenn item nullptr ist, wird point auf das Koordinatensystem der Szene abgebildet.

Siehe auch Konzepte - Visuelle Koordinaten in Qt Quick.

QPointF QQuickItem::mapToScene(const QPointF &point) const

Ordnet den angegebenen point im Koordinatensystem dieses Objekts dem entsprechenden Punkt im Koordinatensystem der Szene zu und gibt die zugeordnete Koordinate zurück.

Die folgenden Eigenschaften des Objekts werden bei der Zuordnung verwendet: x, y, scale, rotation, transformOrigin, und transform.

Wenn die Elemente Teil verschiedener Szenen sind, enthält die Zuordnung die relative Position der beiden Szenen.

Siehe auch Konzepte - Visuelle Koordinaten in Qt Quick.

[virtual protected] void QQuickItem::mouseDoubleClickEvent(QMouseEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Maus-Doppelklick-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

[virtual protected] void QQuickItem::mouseMoveEvent(QMouseEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Mausbewegungsereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Um Mausbewegungsereignisse zu empfangen, muss das vorhergehende Mausdruckereignis akzeptiert werden (z. B. durch Überschreiben von mousePressEvent()) und acceptedMouseButtons() muss die entsprechende Maustaste zurückgeben.

Das Ereignis wird standardmäßig akzeptiert, so dass es nicht notwendig ist, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

[virtual protected] void QQuickItem::mousePressEvent(QMouseEvent *event)

Dieser Eventhandler kann in einer Unterklasse neu implementiert werden, um Mausdruckereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Um Mausdruckereignisse zu empfangen, muss acceptedMouseButtons() die entsprechende Maustaste zurückgeben.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

[virtual protected] void QQuickItem::mouseReleaseEvent(QMouseEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Mausfreigabe-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Um Mausfreigabeereignisse zu empfangen, muss das vorhergehende Mausdruckereignis akzeptiert werden (z. B. durch Überschreiben von mousePressEvent()) und acceptedMouseButtons() muss die entsprechende Maustaste zurückgeben.

Das Ereignis wird standardmäßig akzeptiert, so dass es nicht notwendig ist, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

[virtual protected] void QQuickItem::mouseUngrabEvent()

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um benachrichtigt zu werden, wenn ein Mouse-Ungrab-Ereignis für dieses Element eingetreten ist.

[invokable] QQuickItem *QQuickItem::nextItemInFocusChain(bool forward = true)

Gibt das Element in der Fokuskette zurück, das sich neben diesem Element befindet. Wenn forward gleich true ist oder nicht angegeben wird, handelt es sich um das nächste Element in Vorwärtsrichtung. Wenn forward gleich false ist, handelt es sich um das nächste Element in Rückwärtsrichtung.

void QQuickItem::polish()

Plant ein polnisches Ereignis für dieses Element.

Wenn der Szenengraf die Anfrage verarbeitet, ruft er updatePolish() für dieses Element auf.

Siehe auch updatePolish(), QQuickTest::qIsPolishScheduled(), und ensurePolished().

[virtual protected] void QQuickItem::releaseResources()

Diese Funktion wird aufgerufen, wenn ein Element Grafikressourcen freigeben soll, die nicht bereits von den von QQuickItem::updatePaintNode() zurückgegebenen Knoten verwaltet werden.

Dies geschieht, wenn das Element aus dem Fenster, in dem es zuvor gerendert wurde, entfernt werden soll. Es ist garantiert, dass das Element eine window hat, wenn die Funktion aufgerufen wird.

Die Funktion wird im GUI-Thread aufgerufen und der Zustand des Rendering-Threads ist unbekannt, wenn sie verwendet wird. Objekte sollten nicht direkt gelöscht werden, sondern mit QQuickWindow::scheduleRenderJob() für die Bereinigung eingeplant werden.

Siehe auch Graphics Resource Handling.

QQuickItem *QQuickItem::scopedFocusItem() const

Wenn dieses Element ein Fokusbereich ist, wird das Element in seiner Fokuskette zurückgegeben, das derzeit den Fokus hat.

Gibt nullptr zurück, wenn dieses Element kein Fokusbereich ist.

void QQuickItem::setAcceptHoverEvents(bool enabled)

Wenn enabled wahr ist, wird das Element so eingestellt, dass es Hover-Ereignisse akzeptiert; andernfalls werden Hover-Ereignisse von diesem Element nicht akzeptiert.

Siehe auch acceptHoverEvents().

void QQuickItem::setAcceptTouchEvents(bool enabled)

Wenn enabled wahr ist, wird das Element so eingestellt, dass es Berührungsereignisse akzeptiert; andernfalls werden Berührungsereignisse von diesem Element nicht akzeptiert.

Siehe auch acceptTouchEvents().

void QQuickItem::setAcceptedMouseButtons(Qt::MouseButtons buttons)

Setzt die von diesem Element akzeptierten Maustasten auf buttons.

Siehe auch acceptedMouseButtons().

void QQuickItem::setCursor(const QCursor &cursor)

Legt die Form cursor für dieses Element fest.

Siehe auch cursor() und unsetCursor().

void QQuickItem::setFiltersChildMouseEvents(bool filter)

Legt fest, ob Zeigerereignisse, die für die Kinder dieses Elements bestimmt sind, über dieses Element gefiltert werden sollen.

Wenn filter wahr ist, wird childMouseEventFilter() aufgerufen, wenn ein Zeigerereignis für ein untergeordnetes Element ausgelöst wird.

Siehe auch filtersChildMouseEvents().

void QQuickItem::setFlag(QQuickItem::Flag flag, bool enabled = true)

Aktiviert das angegebene flag für dieses Element, wenn enabled wahr ist; wenn enabled falsch ist, ist das Kennzeichen deaktiviert.

Diese bieten verschiedene Hinweise für das Element; das Kennzeichen ItemClipsChildrenToShape zeigt beispielsweise an, dass alle untergeordneten Elemente dieses Elements beschnitten werden sollten, damit sie in den Elementbereich passen.

void QQuickItem::setFlags(QQuickItem::Flags flags)

Aktiviert die angegebene flags für dieses Element.

Siehe auch flags() und setFlag().

void QQuickItem::setFocusPolicy(Qt::FocusPolicy policy)

Setzt die Fokusrichtlinie dieses Elements auf policy.

Siehe auch focusPolicy().

void QQuickItem::setKeepMouseGrab(bool keep)

Legt fest, ob die Mauseingabe ausschließlich bei diesem Element verbleiben soll.

Dies ist nützlich für Elemente, die die Mausinteraktion nach einer vordefinierten Geste erfassen und beibehalten möchten. Ein Element, das an horizontalen Mausbewegungen interessiert ist, kann zum Beispiel keepMouseGrab auf true setzen, sobald ein Schwellenwert überschritten wurde. Sobald keepMouseGrab auf true gesetzt ist, reagieren die Filterelemente nicht mehr auf Mausereignisse.

Wenn keep auf false gesetzt ist, kann ein filterndes Element den Greifer stehlen. Zum Beispiel kann Flickable versuchen, einen Mausgriff zu stehlen, wenn es erkennt, dass der Benutzer begonnen hat, das Ansichtsfenster zu bewegen.

Siehe auch keepMouseGrab().

void QQuickItem::setKeepTouchGrab(bool keep)

Legt fest, ob die von diesem Element ergriffenen Berührungspunkte ausschließlich bei diesem Element verbleiben sollen.

Dies ist nützlich für Elemente, die bestimmte Berührungspunkte nach einer vordefinierten Geste ergreifen und behalten möchten. Beispielsweise kann ein Element, das an horizontalen Berührungspunktbewegungen interessiert ist, setKeepTouchGrab auf true setzen, sobald ein Schwellenwert überschritten wurde. Sobald setKeepTouchGrab auf true gesetzt wurde, reagieren die Filterelemente nicht mehr auf die entsprechenden Berührungspunkte.

Wenn keep auf false gesetzt ist, kann ein filterndes Element den Greifer stehlen. Zum Beispiel kann Flickable versuchen, einen Berührungspunkt zu stehlen, wenn es feststellt, dass der Benutzer begonnen hat, das Ansichtsfenster zu bewegen.

Siehe auch keepTouchGrab() und setKeepMouseGrab().

void QQuickItem::setSize(const QSizeF &size)

Setzt die Größe des Elements auf size. Diese Methode bewahrt alle bestehenden Bindungen für Breite und Höhe; daher überschreibt jede Änderung, die eine erneute Ausführung der Bindung auslöst, die festgelegten Werte.

Siehe auch size, setWidth, und setHeight.

QSizeF QQuickItem::size() const

Gibt die Größe des Objekts zurück.

Siehe auch setSize, width, und height.

void QQuickItem::stackAfter(const QQuickItem *sibling)

Verschiebt das angegebene Element sibling innerhalb der Liste der untergeordneten Elemente auf den Index nach diesem Element. Die Reihenfolge der Kinder wirkt sich sowohl auf die visuelle Stapelreihenfolge als auch auf die Navigationsreihenfolge des Tab-Fokus aus.

Unter der Annahme, dass die z-Werte der beiden Elemente gleich sind, wird sibling unter diesem Element angezeigt.

Wenn für beide Elemente activeFocusOnTab auf true gesetzt ist, ändert sich auch die Reihenfolge des Registerkartenfokus, wobei sibling den Fokus vor diesem Element erhält.

Das angegebene sibling muss ein Geschwisterelement dieses Elements sein, d. h. sie müssen denselben unmittelbaren parent haben.

Siehe auch Konzepte - Visual Parent in Qt Quick.

void QQuickItem::stackBefore(const QQuickItem *sibling)

Verschiebt das angegebene Element sibling innerhalb der Liste der untergeordneten Elemente auf den Index vor diesem Element. Die Reihenfolge der Kinder wirkt sich sowohl auf die visuelle Stapelreihenfolge als auch auf die Navigationsreihenfolge des Tab-Fokus aus.

Unter der Annahme, dass die z-Werte beider Elemente gleich sind, wird sibling über diesem Element gerendert.

Wenn für beide Elemente activeFocusOnTab auf true gesetzt ist, ändert sich auch die Reihenfolge des Registerkartenfokus, wobei sibling den Fokus nach diesem Element erhält.

Das angegebene sibling muss ein Geschwisterelement dieses Elements sein, d. h. sie müssen denselben unmittelbaren parent haben.

Siehe auch Konzepte - Visual Parent in Qt Quick.

[virtual] QSGTextureProvider *QQuickItem::textureProvider() const

Gibt den Texturanbieter für ein Element zurück. Die Standardimplementierung gibt nullptr zurück.

Diese Funktion darf nur im Rendering-Thread aufgerufen werden.

[virtual protected] void QQuickItem::touchEvent(QTouchEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Berührungsereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

[virtual protected] void QQuickItem::touchUngrabEvent()

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um benachrichtigt zu werden, wenn ein Touch-Ungrab-Ereignis für dieses Element eingetreten ist.

void QQuickItem::unsetCursor()

Löscht die Cursorform für dieses Element.

Siehe auch cursor() und setCursor().

[slot] void QQuickItem::update()

Plant einen Aufruf an updatePaintNode() für diesen Artikel.

Der Aufruf von QQuickItem::updatePaintNode() erfolgt immer dann, wenn das Element in einer QQuickWindow angezeigt wird.

Nur Elemente, die QQuickItem::ItemHasContents angeben, dürfen QQuickItem::update() aufrufen.

[protected] void QQuickItem::updateInputMethod(Qt::InputMethodQueries queries = Qt::ImQueryInput)

Benachrichtigung der Eingabemethode über aktualisierte Abfragewerte, falls erforderlich. queries zeigt die geänderten Attribute an.

[virtual protected] QSGNode *QQuickItem::updatePaintNode(QSGNode *oldNode, QQuickItem::UpdatePaintNodeData *updatePaintNodeData)

Wird im Render-Thread aufgerufen, wenn es an der Zeit ist, den Zustand des Objekts mit dem Szenegraphen zu synchronisieren.

Die Funktion wird als Ergebnis von QQuickItem::update() aufgerufen, wenn der Benutzer das Flag QQuickItem::ItemHasContents für das Element gesetzt hat.

Die Funktion sollte die Wurzel des Unterbaums des Szenengraphen für dieses Element zurückgeben. Die meisten Implementierungen geben einen einzelnen QSGGeometryNode zurück, der die visuelle Darstellung dieses Elements enthält. oldNode ist der Knoten, der beim letzten Aufruf der Funktion zurückgegeben wurde. updatePaintNodeData liefert einen Zeiger auf den QSGTransformNode, der mit diesem QQuickItem verbunden ist.

QSGNode *MyItem::updatePaintNode(QSGNode *node, UpdatePaintNodeData *)
{
    QSGSimpleRectNode *n = static_cast<QSGSimpleRectNode *>(node);
    if (!n) {
        n = new QSGSimpleRectNode();
        n->setColor(Qt::red);
    }
    n->setRect(boundingRect());
    return n;
}

Der Haupt-Thread ist blockiert, während diese Funktion ausgeführt wird, so dass es sicher ist, Werte aus der QQuickItem -Instanz und anderen Objekten im Haupt-Thread zu lesen.

Wenn kein Aufruf von QQuickItem::updatePaintNode() zu tatsächlichen Änderungen des Szenengraphen führt, wie QSGNode::markDirty() oder das Hinzufügen und Entfernen von Knoten, dann kann die zugrunde liegende Implementierung entscheiden, die Szene nicht erneut zu rendern, da das visuelle Ergebnis identisch ist.

Siehe auch QSGMaterial, QSGGeometryNode, QSGGeometry, QSGFlatColorMaterial, QSGTextureMaterial, QSGNode::markDirty(), und Graphics Resource Handling.

[virtual protected] void QQuickItem::updatePolish()

Diese Funktion sollte alle für diesen Gegenstand erforderlichen Gestaltungsarbeiten durchführen.

Wenn polish() aufgerufen wird, plant der Szenengraf ein Polishing-Ereignis für dieses Element. Wenn der Szenengraf bereit ist, dieses Element zu rendern, ruft er updatePolish() auf, um das Elementlayout wie erforderlich zu ändern, bevor er das nächste Bild rendert.

Siehe auch ensurePolished().

QQuickItem *QQuickItem::viewportItem() const

Wenn das Kennzeichen ItemObservesViewport gesetzt ist, wird das nächstgelegene übergeordnete Element mit dem Kennzeichen ItemIsViewport zurückgegeben. Gibt das contentItem des Fensters zurück, wenn das Flag nicht gesetzt ist, oder wenn kein anderes Ansichtsfenster-Element gefunden wird.

Gibt nullptr nur zurück, wenn es kein Ansichtsfenster-Element gibt und dieses Element nicht in einem Fenster angezeigt wird.

Siehe auch clipRect().

[virtual protected] void QQuickItem::wheelEvent(QWheelEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Rad-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden durch den Parameter event bereitgestellt.

Das Ereignis wird standardmäßig akzeptiert, daher ist es nicht notwendig, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren, rufen Sie event->ignore() auf.

[protected] bool QQuickItem::widthValid() const

Gibt zurück, ob die Eigenschaft width explizit festgelegt wurde.

QQuickWindow *QQuickItem::window() const

Gibt das Fenster zurück, in dem dieses Element gerendert wird.

Das Element hat erst dann ein Fenster, wenn es einer Szene zugewiesen wurde. Das Signal windowChanged() benachrichtigt sowohl, wenn das Element in eine Szene eingefügt wird, als auch, wenn es aus einer Szene entfernt wird.

[signal] void QQuickItem::windowChanged(QQuickWindow *window)

Dieses Signal wird ausgegeben, wenn sich der Artikel window ändert.