QQuickItem Class

Documentación de funciones miembro

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

Construye un QQuickItem con la dirección parent.

parent se utilizará como padre de visual parent y de QObject.

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

Destruye el QQuickItem.

bool QQuickItem::acceptHoverEvents() const

Devuelve si los eventos hover son aceptados por este elemento.

El valor por defecto es false.

Si es false, el elemento no recibirá eventos hover a través de las funciones hoverEnterEvent(), hoverMoveEvent() y hoverLeaveEvent().

Véase también setAcceptHoverEvents().

bool QQuickItem::acceptTouchEvents() const

Devuelve si los eventos táctiles son aceptados por este elemento.

El valor por defecto es false.

Si es false, entonces el elemento no recibirá ningún evento táctil a través de la función touchEvent().

Véase también setAcceptTouchEvents().

Qt::MouseButtons QQuickItem::acceptedMouseButtons() const

Devuelve los botones del ratón aceptados por este elemento.

El valor por defecto es Qt::NoButton; es decir, no se acepta ningún botón del ratón.

Si un elemento no acepta el botón del ratón para un evento del ratón en particular, el evento del ratón no será entregado al elemento y será entregado al siguiente elemento en la jerarquía de elementos en su lugar.

Véase también setAcceptedMouseButtons() y acceptTouchEvents().

[virtual] QRectF QQuickItem::boundingRect() const

Devuelve las extensiones del elemento en su propio sistema de coordenadas: un rectángulo desde 0, 0 hasta width() y height().

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

Devuelve el primer elemento hijo visible encontrado en el punto (x, y) dentro del sistema de coordenadas de este elemento.

Devuelve nullptr si no existe tal elemento.

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

Devuelve los hijos de este elemento.

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

Reimplemente este método para filtrar los eventos de puntero que reciben los hijos de este elemento.

Este método sólo será llamado si filtersChildMouseEvents() es true.

Devuelve true si el event especificado no debe pasarse al item hijo especificado , y false en caso contrario. Si devuelve true, también debe accept o ignore el event, para señalar si la propagación de eventos debe detenerse o continuar. El event, sin embargo, siempre será enviado a todos los childMouseEventFilters de la cadena padre.

Véase también setFiltersChildMouseEvents().

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

Reimplementa: QQmlParserStatus::classBegin().

Las clases derivadas deben llamar al método de la clase base antes de añadir su propia acción a realizar en classBegin.

[virtual] QRectF QQuickItem::clipRect() const

Devuelve el área rectangular dentro de este elemento que es visible actualmente en viewportItem(), si hay un viewport y la bandera ItemObservesViewport está activada; en caso contrario, las extensiones de este elemento en su propio sistema de coordenadas: un rectángulo desde 0, 0 hasta width() y height(). Esta es la región que debe permanecer visible si clip es true. También puede utilizarse en updatePaintNode() para limitar los gráficos añadidos al gráfico de la escena.

Por ejemplo, un dibujo grande o un documento de texto grande puede mostrarse en un Flickable que ocupe sólo parte de la ventana de la aplicación: en ese caso, Flickable es el elemento viewport, y un elemento de renderizado de contenido personalizado puede optar por omitir los nodos del gráfico de escena que queden fuera del área visible en ese momento. Si se activa el indicador ItemObservesViewport, esta área cambiará cada vez que el usuario desplace el contenido del elemento Flickable.

En el caso de elementos de vista anidados, clipRect() es la intersección de los boundingRects de todos los ancestros que tengan la bandera ItemIsViewport activada, mapeada al sistema de coordenadas de este elemento.

Véase también boundingRect().

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

Reimplementa: QQmlParserStatus::componentComplete().

Las clases derivadas deben llamar al método de la clase base antes de añadir sus propias acciones a realizar en componentComplete.

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

Devuelve true si este elemento contiene point, que está en coordenadas locales; devuelve false en caso contrario.

Esta función puede sobreescribirse para manejar colisiones de puntos en elementos con formas personalizadas. La implementación por defecto comprueba si el punto está dentro de containmentMask() si está establecido, o dentro de la caja delimitadora en caso contrario.

QCursor QQuickItem::cursor() const

Devuelve la forma del cursor para este elemento.

El cursor del ratón asumirá esta forma cuando esté sobre este elemento, a menos que se establezca un cursor de anulación. Véase list of predefined cursor objects para una gama de formas útiles.

Si no se ha establecido ninguna forma de cursor, devuelve un cursor con la forma Qt::ArrowCursor, aunque puede mostrarse otra forma de cursor si un elemento superpuesto tiene un cursor válido.

Véase también setCursor() y unsetCursor().

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de arrastrar-entrar para un ítem. La información del evento es proporcionada por el parámetro event.

Los eventos de arrastrar y soltar sólo se proporcionan si se ha establecido la bandera ItemAcceptsDrops para este elemento.

El evento es aceptado por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

Véase también Drag y Arrastrar y soltar.

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de arrastre-abandono de un ítem. La información del evento es proporcionada por el parámetro event.

Los eventos de arrastrar y soltar sólo se proporcionan si se ha establecido la bandera ItemAcceptsDrops para este elemento.

El evento es aceptado por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

Véase también Drag y Arrastrar y soltar.

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de arrastrar-mover para un ítem. La información del evento es proporcionada por el parámetro event.

Los eventos de arrastrar y soltar sólo se proporcionan si se ha establecido la bandera ItemAcceptsDrops para este elemento.

El evento es aceptado por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

Véase también Drag y Arrastrar y soltar.

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de caída de un ítem. La información del evento es proporcionada por el parámetro event.

Los eventos de arrastrar y soltar sólo se proporcionan si se ha establecido la bandera ItemAcceptsDrops para este elemento.

El evento es aceptado por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

Véase también Drag y Arrastrar y soltar.

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

Vuelca algunos detalles sobre el árbol visual de los ítems que comienzan con este ítem, recursivamente.

Esta función se introdujo en Qt 6.3.

Véase también Técnicas de depuración y GammaRay's Qt Quick Inspector.

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

Llama a updatePolish()

Esto puede ser útil para elementos como Layouts (o Posicionadores) que retrasan el cálculo de sus implicitWidth y implicitHeight hasta que reciben un PolishEvent.

Normalmente, si, por ejemplo, se añade o elimina un elemento hijo a un Layout, el tamaño implícito no se calcula inmediatamente (esto es una optimización). En algunos casos puede ser deseable consultar el tamaño implícito del layout justo después de añadir un elemento hijo. Si este es el caso, utilice esta función justo antes de consultar el tamaño implícito.

Esta función se introdujo en Qt 6.3.

Véase también updatePolish() y polish().

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

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

bool QQuickItem::filtersChildMouseEvents() const

Devuelve si los eventos de puntero destinados a los elementos hijos de este elemento deben filtrarse a través de este elemento.

Si tanto este elemento como un elemento hijo tienen acceptTouchEvents() true, cuando se produzca una interacción táctil, este elemento filtrará el evento táctil. Pero si este elemento o el hijo no pueden manejar eventos táctiles, childMouseEventFilter() será llamado con un evento de ratón sintetizado.

Véase también setFiltersChildMouseEvents() y childMouseEventFilter().

QQuickItem::Flags QQuickItem::flags() const

Devuelve las banderas de artículo de este artículo.

Véase también setFlags() y setFlag().

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de enfoque de un ítem. La información del evento es proporcionada por el parámetro event.

El evento es aceptado por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

Si reimplementa esta función, debe llamar a la implementación de la clase base.

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de focus-out para un ítem. La información del evento es proporcionada por el parámetro event.

El evento es aceptado por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

[invokable] void QQuickItem::forceActiveFocus()

Fuerza el enfoque activo en el elemento.

Este método establece el foco en el elemento y asegura que todos los objetos FocusScope ancestros en la jerarquía de objetos también reciban focus.

La razón del cambio de foco será Qt::OtherFocusReason. Utilice el método sobrecargado para especificar la razón del foco para permitir un mejor manejo del cambio de foco.

Véase también activeFocus.

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

Fija el foco activo en el elemento con el valor reason.

Este método establece el foco en el elemento y garantiza que todos los objetos FocusScope antecesores en la jerarquía de objetos también reciban focus.

Véase también activeFocus y Qt::FocusReason.

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

Esta función es llamada para manejar los cambios de geometría de este ítem de oldGeometry a newGeometry. Si las dos geometrías son iguales, no hace nada.

Las clases derivadas deben llamar al método de la clase base dentro de su implementación.

Esta función se introdujo en Qt 6.0.

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

Recoge el elemento en una imagen en memoria.

La captura se produce de forma asíncrona y la señal QQuickItemGrabResult::ready() se emite cuando la captura se ha completado.

Utilice targetSize para especificar el tamaño de la imagen de destino. Por defecto, el resultado tendrá el mismo tamaño que item.

Si no se ha podido iniciar la captura, la función devuelve null.

Véase también QQuickWindow::grabWindow().

[protected] bool QQuickItem::heightValid() const

Devuelve si la propiedad de altura se ha establecido explícitamente.

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos hover-enter de un ítem. La información del evento es proporcionada por el parámetro event.

Los eventos hover sólo se proporcionan si acceptHoverEvents() es true.

El evento se acepta por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos hover-leave de un ítem. La información del evento es proporcionada por el parámetro event.

Los eventos hover sólo se proporcionan si acceptHoverEvents() es true.

El evento se acepta por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos hover-move de un ítem. La información del evento es proporcionada por el parámetro event.

Los eventos hover sólo se proporcionan si acceptHoverEvents() es true.

El evento se acepta por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

qreal QQuickItem::implicitWidth() const

Devuelve la anchura del elemento que está implícita en otras propiedades que determinan el contenido.

Véase también setImplicitWidth().

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de métodos de entrada para un elemento. La información del evento es proporcionada por el parámetro event.

El evento es aceptado por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

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

Este método sólo es relevante para los elementos de entrada.

Si este elemento es un elemento de entrada, este método debería reimplementarse para devolver los indicadores de método de entrada relevantes para el query dado.

Véase también QWidget::inputMethodQuery().

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

Devuelve true si este elemento es un antepasado de child (es decir, si este elemento es el padre de child o uno de los antepasados del padre de child).

Véase también parentItem().

[protected] bool QQuickItem::isComponentComplete() const

Devuelve true si se ha completado la construcción del componente QML; en caso contrario, devuelve false.

A menudo es conveniente retrasar algún proceso hasta que el componente se haya completado.

Véase también componentComplete().

bool QQuickItem::isFocusScope() const

Devuelve true si este elemento es un ámbito de enfoque, y false en caso contrario.

[virtual] bool QQuickItem::isTextureProvider() const

Devuelve true si este elemento es un proveedor de textura. La implementación por defecto devuelve false.

Esta función puede ser llamada desde cualquier hilo.

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

Se llama cuando se produce change para este elemento.

value contiene información adicional relativa al cambio, cuando procede.

Si reimplementa este método en una subclase, asegúrese de llamar a

QQuickItem::itemChange(change, value);

típicamente al final de su implementación, para asegurarse de que se emita la señal windowChanged().

bool QQuickItem::keepMouseGrab() const

Devuelve si la entrada del ratón debe permanecer exclusivamente en este elemento.

Véase también setKeepMouseGrab(), QEvent::accept() y QEvent::ignore().

bool QQuickItem::keepTouchGrab() const

Devuelve si los puntos de contacto capturados por este elemento deben permanecer exclusivamente con este elemento.

Véase también setKeepTouchGrab(), keepMouseGrab(), QEvent::accept() y QEvent::ignore().

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de pulsación de teclas para un elemento. La información del evento es proporcionada por el parámetro event.

El evento es aceptado por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de liberación de teclas para un elemento. La información del evento es proporcionada por el parámetro event.

El evento es aceptado por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

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

Mapea el point dado en el sistema global de coordenadas de la pantalla al punto equivalente dentro del sistema de coordenadas de este elemento, y devuelve la coordenada mapeada.

Las siguientes propiedades del elemento se utilizan en el mapeo: x, y, scale, rotation, transformOrigin, y transform.

Si los elementos forman parte de escenas diferentes, el mapeado incluye la posición relativa de las dos escenas.

Por ejemplo, esto puede ser útil para añadir una ventana emergente a un componente Qt Quick.

Véase también Conceptos - Coordenadas visuales en Qt Quick.

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

Asigna el punto point dado en el sistema de coordenadas de item al punto equivalente dentro del sistema de coordenadas de este elemento y devuelve la coordenada asignada.

Las siguientes propiedades del elemento se utilizan en el mapeo: x, y, scale, rotation, transformOrigin, y transform.

Si los elementos forman parte de escenas diferentes, el mapeado incluye la posición relativa de las dos escenas.

Si item es nullptr, esto mapea point desde el sistema de coordenadas de la escena.

Véase también Conceptos - Coordenadas visuales en Qt Quick.

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

Mapea el point dado en el sistema de coordenadas de la escena al punto equivalente dentro del sistema de coordenadas de este elemento, y devuelve la coordenada mapeada.

Las siguientes propiedades del elemento se utilizan en el mapeo: x, y, scale, rotation, transformOrigin, y transform.

Si los elementos forman parte de escenas diferentes, el mapeado incluye la posición relativa de las dos escenas.

Véase también Conceptos - Coordenadas visuales en Qt Quick.

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

Mapea el rect dado en el sistema de coordenadas de item al área rectangular equivalente dentro del sistema de coordenadas de este elemento, y devuelve el valor del rectángulo mapeado.

Las siguientes propiedades del elemento se utilizan en el mapeo: x, y, scale, rotation, transformOrigin, y transform.

Si los elementos forman parte de escenas diferentes, el mapeado incluye la posición relativa de las dos escenas.

Si item es nullptr, esto mapea rect desde el sistema de coordenadas de la escena.

Véase también Conceptos - Coordenadas visuales en Qt Quick.

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

Mapea el rect dado en el sistema de coordenadas de la escena al área rectangular equivalente dentro del sistema de coordenadas de este elemento, y devuelve el valor del rectángulo mapeado.

Las siguientes propiedades del elemento se utilizan en la asignación: x, y, scale, rotation, transformOrigin, y transform.

Si los elementos forman parte de escenas diferentes, el mapeado incluye la posición relativa de las dos escenas.

Véase también Conceptos - Coordenadas visuales en Qt Quick.

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

Mapea el rect dado en el sistema de coordenadas de este elemento al área rectangular equivalente dentro del sistema de coordenadas de item y devuelve el valor del rectángulo mapeado.

Las siguientes propiedades del elemento se utilizan en el mapeo: x, y, scale, rotation, transformOrigin, y transform.

Si los elementos forman parte de escenas diferentes, el mapeado incluye la posición relativa de las dos escenas.

Si item es nullptr, esto mapea rect al sistema de coordenadas de la escena.

Véase también Conceptos - Coordenadas visuales en Qt Quick.

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

Mapea el rect dado en el sistema de coordenadas de este elemento al área rectangular equivalente dentro del sistema de coordenadas de la escena, y devuelve el valor del rectángulo mapeado.

Las siguientes propiedades del elemento se utilizan en la asignación: x, y, scale, rotation, transformOrigin, y transform.

Si los elementos forman parte de escenas diferentes, el mapeado incluye la posición relativa de las dos escenas.

Véase también Conceptos - Coordenadas visuales en Qt Quick.

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

Mapea el point dado en el sistema de coordenadas de este elemento al punto equivalente dentro del sistema global de coordenadas de la pantalla, y devuelve la coordenada mapeada.

Las siguientes propiedades del elemento se utilizan en el mapeo: x, y, scale, rotation, transformOrigin, y transform.

Si los elementos forman parte de escenas diferentes, el mapeado incluye la posición relativa de las dos escenas.

Por ejemplo, esto puede ser útil para añadir una ventana emergente a un componente Qt Quick.

Véase también Conceptos - Coordenadas visuales en Qt Quick.

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

Asigna el punto point dado en el sistema de coordenadas de este elemento al punto equivalente dentro del sistema de coordenadas de item y devuelve la coordenada asignada.

Las siguientes propiedades del elemento se utilizan en el mapeo: x, y, scale, rotation, transformOrigin, y transform.

Si los elementos forman parte de escenas diferentes, el mapeo incluye la posición relativa de las dos escenas.

Si item es nullptr, esto mapea point al sistema de coordenadas de la escena.

Véase también Conceptos - Coordenadas visuales en Qt Quick.

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

Mapea el point dado en el sistema de coordenadas de este elemento al punto equivalente dentro del sistema de coordenadas de la escena, y devuelve la coordenada mapeada.

Las siguientes propiedades del elemento se utilizan en el mapeo: x, y, scale, rotation, transformOrigin, y transform.

Si los elementos forman parte de escenas diferentes, el mapeado incluye la posición relativa de las dos escenas.

Véase también Conceptos - Coordenadas visuales en Qt Quick.

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de doble clic del ratón para un elemento. La información del evento es proporcionada por el parámetro event.

El evento es aceptado por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de movimiento del ratón para un ítem. La información del evento es proporcionada por el parámetro event.

Para recibir eventos de movimiento del ratón, el evento de pulsación del ratón precedente debe ser aceptado (anulando mousePressEvent(), por ejemplo) y acceptedMouseButtons() debe devolver el botón del ratón correspondiente.

El evento se acepta por defecto, por lo que no es necesario aceptarlo explícitamente si se reimplementa esta función. Si no acepta el evento, llame a event->ignore().

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de pulsación del ratón para un elemento. La información del evento es proporcionada por el parámetro event.

Para recibir eventos de pulsación del ratón, acceptedMouseButtons() debe devolver el botón del ratón correspondiente.

El evento es aceptado por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de liberación del ratón para un ítem. La información del evento es proporcionada por el parámetro event.

Para recibir eventos de liberación del ratón, el evento precedente de pulsación del ratón debe ser aceptado (anulando mousePressEvent(), por ejemplo) y acceptedMouseButtons() debe devolver el botón del ratón correspondiente.

El evento se acepta por defecto, por lo que no es necesario aceptarlo explícitamente si se reimplementa esta función. Si no acepta el evento, llame a event->ignore().

[virtual protected] void QQuickItem::mouseUngrabEvent()

Este manejador de eventos puede ser reimplementado en una subclase para ser notificado cuando un evento de desenganche del ratón ha ocurrido en este ítem.

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

Devuelve el elemento de la cadena de enfoque que se encuentra junto a este elemento. Si forward es true, o no se proporciona, es el siguiente elemento en la dirección hacia delante. Si forward es false, es el siguiente elemento en la dirección hacia atrás.

void QQuickItem::polish()

Programa un evento de pulido para este elemento.

Cuando el gráfico de escena procese la solicitud, llamará a updatePolish() en este elemento.

Ver también updatePolish(), QQuickTest::qIsPolishScheduled(), y ensurePolished().

[virtual protected] void QQuickItem::releaseResources()

Se llama a esta función cuando un elemento debe liberar recursos gráficos que aún no están gestionados por los nodos devueltos por QQuickItem::updatePaintNode().

Esto ocurre cuando el elemento está a punto de ser eliminado de la ventana en la que se estaba renderizando previamente. Se garantiza que el elemento tiene un window cuando se llama a la función.

La función es llamada en el hilo GUI y el estado del hilo de renderizado, cuando se utiliza, es desconocido. Los objetos no deben borrarse directamente, sino programarse para su limpieza utilizando QQuickWindow::scheduleRenderJob().

Véase también Graphics Resource Handling.

QQuickItem *QQuickItem::scopedFocusItem() const

Si este elemento es un ámbito de foco, devuelve el elemento de su cadena de foco que actualmente tiene foco.

Devuelve nullptr si este elemento no es un ámbito de enfoque.

void QQuickItem::setAcceptHoverEvents(bool enabled)

Si enabled es verdadero, el elemento acepta eventos hover; en caso contrario, no acepta eventos hover.

Véase también acceptHoverEvents().

void QQuickItem::setAcceptTouchEvents(bool enabled)

Si enabled es verdadero, el elemento acepta eventos táctiles; en caso contrario, no acepta eventos táctiles.

Véase también acceptTouchEvents().

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

Establece los botones del ratón aceptados por este elemento en buttons.

Véase también acceptedMouseButtons().

void QQuickItem::setCursor(const QCursor &cursor)

Establece la forma cursor para este elemento.

Véase también cursor() y unsetCursor().

void QQuickItem::setFiltersChildMouseEvents(bool filter)

Establece si los eventos de puntero destinados a los elementos hijos de este elemento deben filtrarse a través de este elemento.

Si filter es verdadero, se llamará a childMouseEventFilter() cuando se active un evento de puntero para un elemento hijo.

Véase también filtersChildMouseEvents().

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

Activa el indicador flag especificado para este elemento si enabled es verdadero; si enabled es falso, el indicador se desactiva.

Proporcionan varias sugerencias para el elemento; por ejemplo, la bandera ItemClipsChildrenToShape indica que todos los hijos de este elemento deben recortarse para que quepan dentro del área del elemento.

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

Habilita el flags especificado para este elemento.

Véase también flags() y setFlag().

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

Establece la política de enfoque de este elemento en policy.

Véase también focusPolicy().

void QQuickItem::setKeepMouseGrab(bool keep)

Establece si la entrada del ratón debe permanecer exclusivamente con este elemento.

Esto es útil para elementos que desean agarrar y mantener la interacción del ratón siguiendo un gesto predefinido. Por ejemplo, un elemento que está interesado en el movimiento horizontal del ratón puede establecer keepMouseGrab a true una vez que se ha superado un umbral. Una vez que keepMouseGrab se ha establecido en true, los elementos de filtrado no reaccionarán a los eventos del ratón.

Si keep es falso, un elemento de filtrado puede robar el agarre. Por ejemplo, Flickable puede intentar robar una captura del ratón si detecta que el usuario ha empezado a mover la ventana gráfica.

Véase también keepMouseGrab().

void QQuickItem::setKeepTouchGrab(bool keep)

Establece si los puntos táctiles capturados por este elemento deben permanecer exclusivamente con este elemento.

Esto es útil para elementos que desean agarrar y mantener puntos táctiles específicos siguiendo un gesto predefinido. Por ejemplo, un elemento interesado en el movimiento horizontal de los puntos táctiles puede establecer setKeepTouchGrab en true una vez superado un umbral. Una vez que setKeepTouchGrab se ha establecido en true, los elementos de filtrado no reaccionarán a los puntos táctiles relevantes.

Si keep es falso, un elemento filtrante puede robar el agarre. Por ejemplo, Flickable puede intentar robar la captura de un punto táctil si detecta que el usuario ha empezado a mover la ventana gráfica.

Véase también keepTouchGrab() y setKeepMouseGrab().

void QQuickItem::setSize(const QSizeF &size)

Establece el tamaño del elemento en size. Este método conserva cualquier vinculación existente sobre la anchura y la altura; por lo tanto, cualquier cambio que provoque que la vinculación se ejecute de nuevo anulará los valores establecidos.

Véase también size, setWidth, y setHeight.

QSizeF QQuickItem::size() const

Devuelve el tamaño del elemento.

Véase también setSize, width, y height.

void QQuickItem::stackAfter(const QQuickItem *sibling)

Mueve este elemento al índice posterior al elemento hermano especificado dentro de la lista de hijos. El orden de los hijos afecta tanto al orden de apilamiento visual como al orden de navegación del foco de la pestaña.

Asumiendo que los valores z de ambos elementos son los mismos, esto hará que sibling se muestre debajo de este elemento.

Si ambos elementos tienen activeFocusOnTab establecido en true, esto también causará que el orden de enfoque de la pestaña cambie, con sibling recibiendo el enfoque antes que este elemento.

El sibling dado debe ser un hermano de este elemento; es decir, deben tener el mismo parent inmediato.

Véase también Conceptos - Visual Parent en Qt Quick.

void QQuickItem::stackBefore(const QQuickItem *sibling)

Mueve este elemento al índice anterior al elemento hermano especificado dentro de la lista de hijos. El orden de los elementos secundarios afecta tanto al orden de apilamiento visual como al orden de navegación de las pestañas.

Asumiendo que los valores z de ambos elementos son los mismos, esto hará que sibling se muestre por encima de este elemento.

Si ambos elementos tienen activeFocusOnTab establecido en true, esto también hará que el orden de enfoque de la pestaña cambie, con sibling recibiendo el enfoque después de este elemento.

El sibling dado debe ser un hermano de este elemento; es decir, deben tener el mismo parent inmediato.

Véase también Conceptos - Visual Parent en Qt Quick.

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

Devuelve el proveedor de textura de un elemento. La implementación por defecto devuelve nullptr.

Esta función sólo puede ser llamada en el hilo de renderizado.

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos táctiles de un ítem. La información del evento es proporcionada por el parámetro event.

El evento es aceptado por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

[virtual protected] void QQuickItem::touchUngrabEvent()

Este manejador de eventos puede ser reimplementado en una subclase para ser notificado cuando un evento de desasimiento táctil ha ocurrido en este ítem.

void QQuickItem::unsetCursor()

Borra la forma del cursor para este elemento.

Véase también cursor() y setCursor().

[slot] void QQuickItem::update()

Programa una llamada a updatePaintNode() para este elemento.

La llamada a QQuickItem::updatePaintNode() siempre se producirá si el elemento se muestra en QQuickWindow.

Sólo los elementos que especifican QQuickItem::ItemHasContents pueden llamar a QQuickItem::update().

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

Notifica al método de entrada los valores de consulta actualizados si es necesario. queries indica los atributos modificados.

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

Llamada en el hilo de renderizado cuando es el momento de sincronizar el estado del ítem con el gráfico de escena.

La función es llamada como resultado de QQuickItem::update(), si el usuario ha establecido la bandera QQuickItem::ItemHasContents en el elemento.

La función debe devolver la raíz del subárbol del grafo de escena para este elemento. La mayoría de las implementaciones devolverán un único QSGGeometryNode que contiene la representación visual de este elemento. oldNode es el nodo que se devolvió la última vez que se llamó a la función. updatePaintNodeData proporciona un puntero al QSGTransformNode asociado con este QQuickItem.

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;
}

El hilo principal está bloqueado mientras se ejecuta esta función, por lo que es seguro leer valores de la instancia QQuickItem y otros objetos en el hilo principal.

Si ninguna llamada a QQuickItem::updatePaintNode() resulta en cambios reales en el gráfico de la escena, como QSGNode::markDirty() o añadir y eliminar nodos, entonces la implementación subyacente puede decidir no renderizar la escena de nuevo ya que el resultado visual es idéntico.

Véase también QSGMaterial, QSGGeometryNode, QSGGeometry, QSGFlatColorMaterial, QSGTextureMaterial, QSGNode::markDirty(), y Graphics Resource Handling.

[virtual protected] void QQuickItem::updatePolish()

Esta función debe realizar cualquier diseño que se requiera para este elemento.

Cuando se llama a polish(), el gráfico de escena programa un evento de pulido para este elemento. Cuando el grafo de escena está listo para renderizar este ítem, llama a updatePolish() para realizar cualquier diseño requerido antes de renderizar el siguiente cuadro.

Véase también ensurePolished().

QQuickItem *QQuickItem::viewportItem() const

Si la opción ItemObservesViewport está activada, devuelve el elemento padre más cercano con la opción ItemIsViewport. Devuelve el elemento de contenido de la ventana si la bandera no está activada, o si no se encuentra ningún otro elemento de la ventana gráfica.

Devuelve nullptr sólo si no hay ningún elemento en la ventana gráfica y este elemento no se muestra en una ventana.

Véase también clipRect().

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

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de rueda para un ítem. La información del evento es proporcionada por el parámetro event.

El evento es aceptado por defecto, por lo que no es necesario aceptarlo explícitamente si reimplementas esta función. Si no acepta el evento, llame a event->ignore().

[protected] bool QQuickItem::widthValid() const

Devuelve si la propiedad width se ha establecido explícitamente.

QQuickWindow *QQuickItem::window() const

Devuelve la ventana en la que se representa este elemento.

El elemento no tiene una ventana hasta que ha sido asignado a una escena. La señal windowChanged() proporciona una notificación tanto cuando el elemento se introduce en una escena como cuando se elimina de una escena.

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

Esta señal se emite cuando cambia la dirección window del artículo.