QQuickItem Class

Dokumentation zu Member-Funktionen

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

Erstellt ein `QQuickItem` mit dem angegebenen ` parent`.

Der ` parent ` wird sowohl als übergeordnetes Element für ` visual parent ` als auch für ` QObject ` verwendet.

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

Zerstört die „ QQuickItem “.

bool QQuickItem::acceptHoverEvents() const

Gibt an, ob Hover-Ereignisse von diesem Element akzeptiert werden.

Der Standardwert ist „false“.

Ist dieser Wert „false“, 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 “.

Ist dieser Wert „ false “, erhält das Element keine Berührungsereignisse über die Funktion „ touchEvent()“.

Siehe auch „ setAcceptTouchEvents()“.

Qt::MouseButtons QQuickItem::acceptedMouseButtons() const

Gibt die von diesem Element unterstützten 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 weitergeleitet, sondern stattdessen 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 an der Position (x, y) innerhalb des Koordinatensystems dieses Elements gefunden wird.

Gibt „ nullptr “ zurück, wenn kein solches Element vorhanden ist.

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

Gibt die untergeordneten Elemente dieses Elements zurück.

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

Implementieren Sie diese Methode neu, um die Zeigerereignisse zu filtern, die von den untergeordneten Elementen dieses Elements empfangen werden.

Diese Methode wird nur aufgerufen, wenn ` filtersChildMouseEvents()` den Wert ` true` zurückgibt.

Geben Sie ` true ` zurück, wenn das angegebene ` event ` nicht an den angegebenen Unterelement-Filter ` item` weitergeleitet werden soll, und andernfalls ` false `. Wenn Sie ` true` zurückgeben, sollten Sie außerdem ` accept ` oder ` ignore ` für den ` event` festlegen, um zu signalisieren, ob die Ereignisweitergabe gestoppt oder fortgesetzt werden soll. Das ` event ` wird jedoch immer an alle `childMouseEventFilters` entlang der übergeordneten Kette gesendet.

Siehe auch ` setFiltersChildMouseEvents()`.

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

Implementiert: ` QQmlParserStatus::classBegin()`.

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

[virtual] QRectF QQuickItem::clipRect() const

Gibt den rechteckigen Bereich innerhalb dieses Elements zurück, der derzeit in viewportItem() sichtbar ist, sofern ein Viewport vorhanden ist und das Flag „ ItemObservesViewport “ gesetzt ist; andernfalls die Ausdehnung 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 Szenengraphen hinzugefügten Grafiken zu begrenzen.

Beispielsweise könnte eine große Zeichnung oder ein umfangreiches Textdokument in einem „Flickable“ angezeigt werden, das nur einen Teil des Anwendungsfensters einnimmt: In diesem Fall ist „Flickable“ das Viewport-Element, und ein benutzerdefiniertes Element zur Inhaltsdarstellung kann Scene-Graph-Knoten weglassen, die außerhalb des aktuell sichtbaren Bereichs liegen. Ist das Flag „ ItemObservesViewport “ gesetzt, ändert sich dieser Bereich jedes Mal, wenn der Benutzer den Inhalt im „Flickable“ scrollt.

Bei verschachtelten Viewport-Elementen ist `clipRect()` die Schnittmenge der ` boundingRect`-Werte aller übergeordneten Elemente, bei denen das Flag ` ItemIsViewport ` gesetzt ist, abgebildet auf das Koordinatensystem dieses Elements.

Siehe auch ` boundingRect()`.

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

Implementiert: ` QQmlParserStatus::componentComplete()`.

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

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

Gibt „ true “ zurück, wenn dieses Element „ point “ enthält, das in lokalen Koordinaten angegeben ist; andernfalls wird „ false “ zurückgegeben.

Diese Funktion kann überschrieben werden, um Punktkollisionen in Elementen mit benutzerdefinierten Formen zu behandeln. Die Standardimplementierung prüft, ob sich der Punkt innerhalb von ` containmentMask()` befindet, sofern dieser festgelegt ist, oder andernfalls innerhalb der Begrenzungsbox.

QCursor QQuickItem::cursor() const

Gibt die Cursorform für dieses Element zurück.

Der Mauszeiger nimmt diese Form an, wenn er sich über diesem Element befindet, sofern kein eigener Mauszeiger festgelegt wurde. Eine Auswahl nützlicher Formen finden Sie unter list of predefined cursor objects.

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

Siehe auch „ setCursor()“ und „ unsetCursor()“.

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

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

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

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

Siehe auch „ Drag “ und „Drag & Drop“.

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

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

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

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

Siehe auch „ Drag “ und „Drag-and-Drop“.

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

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

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

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

Siehe auch „ Drag “ und „Drag-and-Drop“.

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

Dieser Ereignis-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 für dieses Element das Flag „ ItemAcceptsDrops “ gesetzt wurde.

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

Siehe auch „ Drag “ und „Drag-and-Drop“.

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

Gibt rekursiv einige Details zum visuellen Baum der Elemente aus, beginnend mit diesem Element.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch „Debugging-Techniken“ und den „ Qt Quick -Inspector“ von GammaRay.

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

Normalerweise wird die implizite Größe nicht sofort berechnet, wenn beispielsweise ein untergeordnetes Element zu einem Layout hinzugefügt oder daraus entfernt wird (dies ist eine Optimierung). In manchen Fällen kann es wünschenswert sein, die implizite Größe des Layouts unmittelbar nach dem Hinzufügen eines untergeordneten Elements abzufragen. Verwenden Sie in diesem Fall diese Funktion direkt 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)

Implementiert: ` QObject::event(QEvent *e)`.

bool QQuickItem::filtersChildMouseEvents() const

Gibt zurück, ob Zeigerereignisse, die für die untergeordneten Elemente dieses Elements bestimmt sind, über dieses Element gefiltert werden sollen.

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

Siehe auch „ setFiltersChildMouseEvents()“ und „ childMouseEventFilter()“.

QQuickItem::Flags QQuickItem::flags() const

Gibt die Elementflags für dieses Element zurück.

Siehe auch setFlags() und setFlag().

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

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

Das Ereignis wird standardmäßig angenommen, daher ist es nicht erforderlich, das Ereignis explizit anzunehmen, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht annehmen möchten, 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 Ereignis-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, sodass es nicht erforderlich ist, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren möchten, rufen Sie „ event->ignore() “ auf.

[invokable] void QQuickItem::forceActiveFocus()

Setzt den Fokus aktiv auf das Element.

Diese Methode setzt den Fokus auf das Element und stellt sicher, dass alle übergeordneten Objekte vom Typ „ FocusScope “ in der Objekthierarchie ebenfalls den Fokus erhalten focus.

Der Grund für die Fokusänderung ist „ Qt::OtherFocusReason “. Verwenden Sie die überladene Methode, um den Fokusgrund anzugeben und so eine bessere Handhabung der Fokusänderung zu ermöglichen.

Siehe auch activeFocus.

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

Setzt den aktiven Fokus auf das Element mit der angegebenen ID „ reason “.

Diese Methode setzt den Fokus auf das Element und stellt sicher, dass alle übergeordneten Objekte vom Typ „ FocusScope “ in der Objekthierarchie ebenfalls den Wert „ 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 Änderungen an der Geometrie dieses Elements von oldGeometry zu newGeometry zu verarbeiten. Sind die beiden Geometrien identisch, wird nichts unternommen.

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

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Lädt das Element in ein Speicherabbild.

Das Laden erfolgt asynchron, und das Signal ` QQuickItemGrabResult::ready()` wird ausgelöst, sobald der Ladevorgang abgeschlossen ist.

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

Wenn die Erfassung nicht initiiert werden konnte, gibt die Funktion ` null` zurück.

Siehe auch QQuickWindow::grabWindow().

[protected] bool QQuickItem::heightValid() const

Gibt zurück, ob die Eigenschaft „height“ explizit festgelegt wurde.

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

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

Hover-Ereignisse werden nur bereitgestellt, wenn „ acceptHoverEvents()“ auf „true“ gesetzt ist.

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

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

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

Hover-Ereignisse werden nur bereitgestellt, wenn acceptHoverEvents() den Wert „true“ hat.

Das Ereignis wird standardmäßig angenommen, sodass es nicht erforderlich ist, das Ereignis explizit anzunehmen, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht annehmen möchten, rufen Sie ` event->ignore()` auf.

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

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

Hover-Ereignisse werden nur bereitgestellt, wenn „ acceptHoverEvents()“ auf „true“ gesetzt ist.

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

qreal QQuickItem::implicitWidth() const

Gibt die Breite des Elements zurück, die sich aus anderen Eigenschaften ergibt, die den Inhalt bestimmen.

Siehe auch „ setImplicitWidth()“.

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

Dieser Ereignishandler kann in einer Unterklasse neu implementiert werden, um Eingabemethoden-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden über den Parameter „ event “ bereitgestellt.

Das Ereignis wird standardmäßig akzeptiert, sodass es nicht erforderlich ist, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren möchten, 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 die angegebene ` query` zurückzugeben.

Siehe auch ` QWidget::inputMethodQuery()`.

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

Gibt „ true “ zurück, wenn dieses Element ein Vorfahr von „ child “ ist (d. h., wenn dieses Element das übergeordnete Element von „ child “ ist oder zu den Vorfahren eines der übergeordneten Elemente von „ child “ gehört).

Siehe auch parentItem().

[protected] bool QQuickItem::isComponentComplete() const

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

Häufig ist es wünschenswert, bestimmte Verarbeitungsschritte zu verzögern, bis die Komponente fertiggestellt ist.

Siehe auch ` componentComplete()`.

bool QQuickItem::isFocusScope() const

Gibt „true“ zurück, wenn es sich bei diesem Element um einen Fokusbereich handelt, andernfalls „false“.

[virtual] bool QQuickItem::isTextureProvider() const

Gibt „true“ zurück, wenn dieses Element ein Textur-Provider 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 für dieses Element „ change “ auftritt.

value Enthält gegebenenfalls zusätzliche Informationen zur Änderung.

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

QQuickItem::itemChange(change, value);

in der Regel am Ende Ihrer Implementierung aufrufen, um sicherzustellen, dass das Signal „ windowChanged()“ ausgelöst wird.

bool QQuickItem::keepMouseGrab() const

Gibt zurück, ob die Maus-Eingabe ausschließlich bei diesem Element verbleiben soll.

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

bool QQuickItem::keepTouchGrab() const

Gibt zurück, ob die von diesem Element erfassten Berührungspunkte ausschließlich bei diesem Element verbleiben sollen.

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

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

Dieser Ereignisbehandler kann in einer Unterklasse neu implementiert werden, um Tastendruckereignisse für ein Element zu empfangen. Die Ereignisinformationen werden über den Parameter „ event “ bereitgestellt.

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

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

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

Das Ereignis wird standardmäßig angenommen, sodass es nicht erforderlich ist, das Ereignis explizit anzunehmen, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht annehmen möchten, rufen Sie ` event->ignore()` auf.

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

Ordnet die angegebene point im globalen Bildschirmkoordinatensystem dem entsprechenden Punkt im Koordinatensystem dieses Elements zu und gibt die zugeordnete Koordinate 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, umfasst die Zuordnung die relative Position der beiden Szenen.

Dies kann beispielsweise hilfreich sein, um ein Popup zu einer „ Qt Quick “-Komponente hinzuzufügen.

Siehe auch „Konzepte – Visuelle Koordinaten“ unter Qt Quick.

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

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

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

Wenn die Elemente Teil verschiedener Szenen sind, umfasst die Zuordnung die relative Position der beiden Szenen.

Wenn „ item “ auf „ nullptr “ gesetzt ist, erfolgt die Zuordnung von „ point “ ausgehend vom Koordinatensystem der Szene.

Siehe auch „Konzepte – Visuelle Koordinaten“ unter Qt Quick.

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

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

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

Wenn die Elemente Teil unterschiedlicher Szenen sind, umfasst die Zuordnung die relative Position der beiden Szenen.

Siehe auch „Konzepte – Visuelle Koordinaten“ unter Qt Quick.

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

Ordnet die im Koordinatensystem von item angegebenen Koordinaten rect dem entsprechenden rechteckigen Bereich 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, umfasst die Zuordnung die relative Position der beiden Szenen.

Wenn „ item “ auf „ nullptr “ gesetzt ist, erfolgt die Zuordnung von „ rect “ aus dem Koordinatensystem der Szene.

Siehe auch „Konzepte – Visuelle Koordinaten“ unter Qt Quick.

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

Ordnet die angegebenen Koordinaten „ rect “ im Koordinatensystem der Szene dem entsprechenden rechteckigen Bereich 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, umfasst die Zuordnung die relative Position der beiden Szenen.

Siehe auch „Konzepte – Visuelle Koordinaten“ unter Qt Quick.

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

Ordnet die im Koordinatensystem dieses Elements angegebene rect dem entsprechenden rechteckigen Bereich im Koordinatensystem von item 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, umfasst die Zuordnung die relative Position der beiden Szenen.

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

Siehe auch „Konzepte – Visuelle Koordinaten“ unter Qt Quick.

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

Ordnet die im Koordinatensystem dieses Elements angegebene „ rect “ dem entsprechenden rechteckigen Bereich im Koordinatensystem der Szene 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, umfasst die Zuordnung die relative Position der beiden Szenen.

Siehe auch „Konzepte – Visuelle Koordinaten“ unter Qt Quick.

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

Ordnet die im Koordinatensystem dieses Elements angegebene „ point “ dem entsprechenden Punkt im globalen Bildschirmkoordinatensystem zu und gibt die zugeordnete Koordinate 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, umfasst die Zuordnung die relative Position der beiden Szenen.

Dies kann beispielsweise hilfreich sein, um ein Popup zu einer „ Qt Quick “-Komponente hinzuzufügen.

Siehe auch „Konzepte – Visuelle Koordinaten“ unter Qt Quick.

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

Ordnet die im Koordinatensystem dieses Elements angegebene Koordinate „ point “ dem entsprechenden Punkt im Koordinatensystem von „ item “ zu und gibt die zugeordnete Koordinate 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, umfasst die Zuordnung die relative Position der beiden Szenen.

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

Siehe auch „Konzepte – Visuelle Koordinaten“ unter Qt Quick.

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

Ordnet die in diesem Element im Koordinatensystem „ point “ angegebene Koordinate dem entsprechenden Punkt im Koordinatensystem der Szene zu und gibt die zugeordnete Koordinate zurück.

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

Wenn die Elemente Teil verschiedener Szenen sind, umfasst die Zuordnung die relative Position der beiden Szenen.

Siehe auch „Konzepte – Visuelle Koordinaten“ unter Qt Quick.

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

Dieser Ereignishandler kann in einer Unterklasse neu implementiert werden, um Doppelklick-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden über den Parameter „ event “ bereitgestellt.

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

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

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

Um Mausbewegungsereignisse zu empfangen, muss das vorangehende Mausklick-Ereignis akzeptiert werden (beispielsweise durch Überschreiben von ` mousePressEvent()`) und ` acceptedMouseButtons()` muss die entsprechende Maustaste zurückgeben.

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

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

Dieser Ereignishandler kann in einer Unterklasse neu implementiert werden, um Mausklick-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden über den Parameter „ event “ bereitgestellt.

Um Mausklick-Ereignisse zu empfangen, muss ` acceptedMouseButtons()` die entsprechende Maustaste zurückgeben.

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

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

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

Um Mausloslass-Ereignisse zu empfangen, muss das vorangehende Mausdruck-Ereignis akzeptiert werden (beispielsweise durch Überschreiben von ` mousePressEvent()`) und ` acceptedMouseButtons()` muss die entsprechende Maustaste zurückgeben.

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

[virtual protected] void QQuickItem::mouseUngrabEvent()

Dieser Ereignishandler kann in einer Unterklasse neu implementiert werden, um benachrichtigt zu werden, wenn für dieses Element ein „MouseUnGrab“-Ereignis aufgetreten ist.

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

Gibt das Element in der Fokus-Kette zurück, das sich direkt neben diesem Element befindet. Wenn forward der Wert „ true “ ist oder nicht angegeben wird, handelt es sich um das nächste Element in Vorwärtsrichtung. Wenn forward der Wert „ false “ ist, handelt es sich um das nächste Element in Rückwärtsrichtung.

void QQuickItem::polish()

Plant eine polnische Veranstaltung für dieses Element.

Wenn der Szenengraph die Anforderung verarbeitet, ruft er die Methode „ 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 noch nicht von den Knoten verwaltet werden, die von ` QQuickItem::updatePaintNode()` zurückgegeben wurden.

Dies geschieht, wenn das Element kurz davor steht, aus dem Fenster entfernt zu werden, in dem es zuvor gerendert wurde. Es ist gewährleistet, dass das Element zum Zeitpunkt des Aufrufs dieser Funktion über ein ` window ` verfügt.

Die Funktion wird im GUI-Thread aufgerufen, und der Status des Rendering-Threads ist, sofern dieser verwendet wird, unbekannt. Objekte sollten nicht direkt gelöscht, sondern stattdessen mithilfe von ` QQuickWindow::scheduleRenderJob()` zur Bereinigung eingeplant werden.

Siehe auch ` Graphics Resource Handling`.

QQuickItem *QQuickItem::scopedFocusItem() const

Wenn es sich bei diesem Element um ein Fokus-Scope handelt, gibt diese Funktion das Element in seiner Fokus-Kette zurück, das derzeit den Fokus hat.

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

void QQuickItem::setAcceptHoverEvents(bool enabled)

Wenn „ enabled “ auf „true“ gesetzt ist, wird das Element so konfiguriert, 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)

Legt die von diesem Element akzeptierten Maustasten auf „ buttons “ fest.

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 untergeordneten Elemente dieses Elements bestimmt sind, über dieses Element gefiltert werden sollen.

Ist „ filter “ auf „true“ gesetzt, wird „ childMouseEventFilter()“ aufgerufen, sobald 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 “ auf „true“ gesetzt ist; ist „ enabled “ auf „false“ gesetzt, ist das Flag deaktiviert.

Diese bieten verschiedene Hinweise für das Element; beispielsweise gibt das Flag „ ItemClipsChildrenToShape “ an, dass alle untergeordneten Elemente dieses Elements so beschnitten werden sollen, dass sie in den Bereich des Elements 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)

Legt die Fokusrichtlinie für dieses Element auf „ policy “ fest.

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 nach einer vordefinierten Geste die Mausinteraktion übernehmen und beibehalten möchten. Beispielsweise kann ein Element, das an horizontalen Mausbewegungen interessiert ist, „ keepMouseGrab “ auf „true“ setzen, sobald ein Schwellenwert überschritten wurde. Sobald „ keepMouseGrab “ auf „true“ gesetzt wurde, reagieren filternde Elemente nicht mehr auf Mausereignisse.

Ist „ keep “ auf „false“ gesetzt, kann ein Filterelement die Mauskontrolle übernehmen. Beispielsweise kann „ Flickable “ versuchen, die Mauskontrolle zu übernehmen, wenn es erkennt, dass der Benutzer begonnen hat, den Ansichtsbereich zu verschieben.

Siehe auch „ keepMouseGrab()“.

void QQuickItem::setKeepTouchGrab(bool keep)

Legt fest, ob die von diesem Element erfassten Berührungspunkte ausschließlich diesem Element zugeordnet bleiben sollen.

Dies ist nützlich für Elemente, die bestimmte Berührungspunkte nach einer vordefinierten Geste erfassen 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 filternde Elemente nicht mehr auf die betreffenden Berührungspunkte.

Ist „ keep “ auf „false“ gesetzt, kann ein Filterelement die Erfassung übernehmen. Beispielsweise könnte „ Flickable “ versuchen, die Erfassung eines Berührungspunkts zu übernehmen, wenn es feststellt, dass der Benutzer begonnen hat, den Ansichtsbereich zu verschieben.

Siehe auch „ keepTouchGrab()“ und „ setKeepMouseGrab()“.

void QQuickItem::setSize(const QSizeF &size)

Legt die Größe des Elements auf size fest. Diese Methode behält alle bestehenden Bindungen für Breite und Höhe bei; daher überschreiben alle Änderungen, die eine erneute Ausführung der Bindung auslösen, die festgelegten Werte.

Siehe auch size, setWidth und setHeight.

QSizeF QQuickItem::size() const

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

Siehe auch „ setSize “, „ width “ und „ height “.

void QQuickItem::stackAfter(const QQuickItem *sibling)

Verschiebt dieses Element in der Liste der untergeordneten Elemente an die Stelle nach dem angegebenen gleichrangigen Element. Die Reihenfolge der untergeordneten Elemente wirkt sich sowohl auf die visuelle Stapelreihenfolge als auch auf die Navigationsreihenfolge beim Tabulatortasten-Fokus aus.

Unter der Annahme, dass die z-Werte beider Elemente identisch sind, führt dies dazu, dass „ sibling “ unterhalb dieses Elements dargestellt wird.

Wenn bei beiden Elementen „ activeFocusOnTab “ auf „ true “ gesetzt ist, ändert sich dadurch auch die Tabulator-Fokusreihenfolge, sodass „ sibling “ vor diesem Element den Fokus erhält.

Das angegebene „ sibling “ muss ein Geschwisterelement dieses Elements sein; das heißt, beide müssen denselben unmittelbaren „ parent “ haben.

Siehe auch „Konzepte – Visuelles übergeordnetes Element“ unter Qt Quick.

void QQuickItem::stackBefore(const QQuickItem *sibling)

Verschiebt dieses Element in der Liste der untergeordneten Elemente an die Position vor dem angegebenen gleichrangigen Element. Die Reihenfolge der untergeordneten Elemente wirkt sich sowohl auf die visuelle Stapelreihenfolge als auch auf die Navigationsreihenfolge beim Tabulatortasten-Fokus aus.

Unter der Annahme, dass die z-Werte beider Elemente identisch sind, führt dies dazu, dass „ sibling “ über diesem Element dargestellt wird.

Wenn bei beiden Elementen „ activeFocusOnTab “ auf „ true “ gesetzt ist, ändert sich dadurch auch die Tabulator-Fokusreihenfolge, sodass „ sibling “ nach diesem Element den Fokus erhält.

Das angegebene „ sibling “ muss ein Geschwisterelement dieses Elements sein; das heißt, beide müssen denselben unmittelbaren „ parent “ haben.

Siehe auch „Konzepte – Visuelles übergeordnetes Element“ unter Qt Quick.

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

Gibt den Textur-Provider 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 Ereignis-Handler kann in einer Unterklasse neu implementiert werden, um Berührungsereignisse für ein Element zu empfangen. Die Ereignisinformationen werden über den Parameter „ event “ bereitgestellt.

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

[virtual protected] void QQuickItem::touchUngrabEvent()

Dieser Ereignis-Handler kann in einer Unterklasse neu implementiert werden, um benachrichtigt zu werden, wenn bei diesem Element ein „Touch-Ungrab“-Ereignis aufgetreten ist.

void QQuickItem::unsetCursor()

Löscht die Cursorform für dieses Element.

Siehe auch cursor() und setCursor().

[slot] void QQuickItem::update()

Plant einen Aufruf von ` updatePaintNode()` für dieses Element ein.

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

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

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

Benachrichtigen Sie die Eingabemethode bei Bedarf über aktualisierte Abfragewerte. „ queries “ gibt die geänderten Attribute an.

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

Wird im Render-Thread aufgerufen, wenn der Status des Elements mit dem Szenengraphen synchronisiert werden muss.

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

Die Funktion sollte die Wurzel des Szenenbaum-Unterbaums für dieses Element zurückgeben. Die meisten Implementierungen geben ein einzelnes ` QSGGeometryNode ` zurück, das 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 diesem ` QQuickItem` zugeordnet 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 Hauptthread wird während der Ausführung dieser Funktion gesperrt, sodass es sicher ist, Werte aus der Instanz „ QQuickItem “ und anderen Objekten im Hauptthread auszulesen.

Wenn kein Aufruf von `QQuickItem::updatePaintNode()` zu tatsächlichen Änderungen am Szenengraphen führt, wie z. B. ` QSGNode::markDirty()` oder das Hinzufügen und Entfernen von Knoten, 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 das für dieses Element erforderliche Layout ausführen.

Wenn „ polish()“ aufgerufen wird, plant der Szenengraph ein „polish“-Ereignis für dieses Element ein. Sobald der Szenengraph bereit ist, dieses Element zu rendern, ruft er „updatePolish()“ auf, um das erforderliche Layout des Elements durchzuführen, bevor er den nächsten Frame rendert.

Siehe auch ` ensurePolished()`.

QQuickItem *QQuickItem::viewportItem() const

Wenn das Flag „ ItemObservesViewport “ gesetzt ist, gibt die Methode das nächstgelegene übergeordnete Element mit dem Flag „ ItemIsViewport “ zurück. Ist das Flag nicht gesetzt oder wird kein anderes Viewport-Element gefunden, gibt die Methode das „contentItem“ des Fensters zurück.

Gibt „ nullptr “ nur zurück, wenn kein Viewport-Element vorhanden ist und dieses Element nicht in einem Fenster angezeigt wird.

Siehe auch „ clipRect()“.

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

Dieser Ereignis-Handler kann in einer Unterklasse neu implementiert werden, um Räder-Ereignisse für ein Element zu empfangen. Die Ereignisinformationen werden über den Parameter „ event “ bereitgestellt.

Das Ereignis wird standardmäßig akzeptiert, sodass es nicht erforderlich ist, das Ereignis explizit zu akzeptieren, wenn Sie diese Funktion neu implementieren. Wenn Sie das Ereignis nicht akzeptieren möchten, 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 dargestellt wird.

Das Element verfügt erst dann über ein Fenster, wenn es einer Szene zugewiesen wurde. Das Signal „ windowChanged()“ löst sowohl dann eine Benachrichtigung aus, wenn das Element in eine Szene eingefügt wird, als auch dann, wenn es aus einer Szene entfernt wird.

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

Dieses Signal wird ausgelöst, wenn sich die „ window “ des Elements ändert.