SwipeDelegate QML Type
Delegado de elemento deslizable. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- swipe
- swipe.behind : Component
- swipe.behindItem : Item
- swipe.complete : bool
- swipe.enabled : bool
- swipe.left : Component
- swipe.leftItem : Item
- swipe.position : real
- swipe.right : Component
- swipe.rightItem : Item
- swipe.transition : Transition
Propiedades adjuntas
- pressed : bool
(since QtQuick.Controls 2.1 (Qt 5.8))
Señales
- void swipe.closed()
(since QtQuick.Controls 2.2 (Qt 5.9)) - void swipe.completed()
(since QtQuick.Controls 2.1 (Qt 5.8)) - void swipe.opened()
(since QtQuick.Controls 2.2 (Qt 5.9))
Señales adjuntas
- clicked()
(since QtQuick.Controls 2.1 (Qt 5.8))
Métodos
- void swipe.close()
(since QtQuick.Controls 2.1 (Qt 5.8)) - void swipe.open(enumeration side)
(since QtQuick.Controls 2.2 (Qt 5.9))
Descripción detallada
SwipeDelegate presenta un elemento de vista que se puede deslizar hacia la izquierda o hacia la derecha para mostrar más opciones o información. Se utiliza como delegado en vistas como ListView.
En el siguiente ejemplo, SwipeDelegate se utiliza en un ` ListView ` para permitir que se eliminen elementos de él deslizando el dedo hacia la izquierda:
ListView {
id: listView
anchors.fill: parent
model: ListModel {
ListElement { sender: "Bob Bobbleton"; title: "How are you going?" }
ListElement { sender: "Rug Emporium"; title: "SALE! All rugs MUST go!" }
ListElement { sender: "Electric Co."; title: "Electricity bill 15/07/2016 overdue" }
ListElement { sender: "Tips"; title: "Five ways this tip will save your life" }
}
delegate: SwipeDelegate {
id: swipeDelegate
text: sender + " - " + title
width: listView.width
required property string sender
required property string title
required property int index
ListView.onRemove: removeAnimation.start()
SequentialAnimation {
id: removeAnimation
PropertyAction {
target: swipeDelegate
property: "ListView.delayRemove"
value: true
}
NumberAnimation {
target: swipeDelegate
property: "height"
to: 0
easing.type: Easing.InOutQuad
}
PropertyAction {
target: swipeDelegate
property: "ListView.delayRemove"
value: false
}
}
swipe.right: Label {
id: deleteLabel
text: qsTr("Delete")
color: "white"
verticalAlignment: Label.AlignVCenter
padding: 12
height: parent.height
anchors.right: parent.right
SwipeDelegate.onClicked: listView.model.remove(index)
background: Rectangle {
color: deleteLabel.SwipeDelegate.pressed ? Qt.darker("tomato", 1.1) : "tomato"
}
}
}
}SwipeDelegate hereda su API de ItemDelegate, que a su vez la hereda de AbstractButton. Por ejemplo, puedes establecer text y reaccionar ante clicks utilizando la API de AbstractButton.
Tanto la información sobre el progreso de un deslizamiento como los componentes que deben mostrarse al deslizar están disponibles a través del objeto de propiedad agrupada swipe. Por ejemplo, ` swipe.position ` contiene la posición del deslizamiento dentro del rango ` -1.0 ` a ` 1.0`. La propiedad ` swipe.left ` determina qué elemento se mostrará cuando se deslice el control hacia la derecha, y viceversa para ` swipe.right`. La posición de estos componentes queda a criterio de las aplicaciones. Por ejemplo, si no se especifica ninguna posición para ` swipe.left ` o ` swipe.right`, ocurrirá lo siguiente:
Si swipe.left y swipe.right están anclados a la izquierda y a la derecha del elemento background (respectivamente), se comportarán así:
Al utilizar swipe.left y swipe.right, no es posible deslizar el control más allá de los bordes izquierdo y derecho. Para conseguir este tipo de comportamiento de «ajuste», configura swipe.behind en su lugar. De este modo, se mostrará el mismo elemento independientemente de la dirección en la que se deslice el control. Por ejemplo, en la imagen siguiente, hemos configurado swipe.behind y, a continuación, deslizamos el control repetidamente en ambas direcciones:
Véase también Personalización deSwipeDelegate, Controles delegados y Ejemplo de galería.
Documentación de la propiedad
swipe group
swipe.behind : Component
swipe.behindItem : Item
swipe.complete : bool
swipe.enabled : bool
swipe.left : Component
swipe.leftItem : Item
swipe.position : real
swipe.right : Component
swipe.rightItem : Item
swipe.transition : Transition
| Nombre | Descripción |
|---|---|
| posición | Esta propiedad de solo lectura contiene la posición del deslizamiento respecto a cualquiera de los lados del control. Cuando este valor alcance -1.0 (lado izquierdo) o 1.0 (lado derecho) y se suelte el botón del ratón, complete será true. |
| completo | Esta propiedad de solo lectura indica si el control queda totalmente visible tras haberlo deslizado hacia la izquierda o hacia la derecha. Cuando «complete» es « |
| enabled | Esta propiedad determina si el control se puede deslizar o no. Esta propiedad se añadió en QtQuick.Controls 2.2. |
| izquierda | Esta propiedad contiene el delegado «left». El delegado de la izquierda se sitúa detrás tanto de « contentItem » como de « background ». Cuando se desliza el « SwipeDelegate » hacia la derecha, este elemento se irá revelando gradualmente. Aquí se pueden utilizar tanto elementos interactivos como no interactivos. Se aplican las reglas habituales de gestión de eventos; si se utiliza un control interactivo como Button, las señales de interacción de SwipeDelegate, como clicked(), no se emitirán al hacer clic en el botón. |
| behind | Esta propiedad contiene el delegado que se muestra cuando se desliza el SwipeDelegate tanto hacia la izquierda como hacia la derecha. Al igual que con los delegados de Aquí se pueden utilizar tanto elementos interactivos como no interactivos. Se aplican las reglas habituales de gestión de eventos; si se utiliza un control interactivo como Button, las señales de interacción de SwipeDelegate, como clicked(), no se emitirán al hacer clic en el botón. |
| derecha | Esta propiedad contiene el delegado derecho. El delegado derecho se sitúa detrás tanto de contentItem como de background. Cuando se desliza el SwipeDelegate hacia la izquierda, este elemento se mostrará gradualmente. Aquí se pueden utilizar tanto elementos interactivos como no interactivos. Se aplican las reglas habituales de gestión de eventos; si se utiliza un control interactivo como Button, las señales de interacción de SwipeDelegate, como clicked(), no se emitirán al hacer clic en el botón. |
| leftItem | Esta propiedad de solo lectura contiene el elemento instanciado a partir del componente left.Si no se ha establecido |
| behindItem | Esta propiedad de solo lectura contiene el elemento instanciado a partir del componente « behind ».Si no se ha establecido |
| rightItem | Esta propiedad de solo lectura contiene el elemento instanciado a partir del componente « right ».Si no se ha establecido |
| transition | Esta propiedad contiene la transición que se aplica al soltar un deslizamiento, o al llamar a ` swipe.open()` o ` swipe.close()`.Esta propiedad se añadió en QtQuick.Controls 2.2. |
Véase también ` contentItem`, ` background`, ` swipe.open()` y ` swipe.close()`.
Documentación de la propiedad adjunta
SwipeDelegate.pressed : bool [read-only attached, since QtQuick.Controls 2.1 (Qt 5.8)]
Esta propiedad se puede asociar a un elemento no interactivo declarado en swipe.left, swipe.right o swipe.behind, con el fin de detectar si se pulsa. Los elementos solo se pueden pulsar cuando swipe.complete es true.
Por ejemplo:
swipe.right: Label {
anchors.right: parent.right
height: parent.height
text: "Action"
color: "white"
padding: 12
background: Rectangle {
color: SwipeDelegate.pressed ? Qt.darker("tomato", 1.1) : "tomato"
}
}Es posible tener varios elementos que reciban individualmente eventos de ratón y táctiles. Por ejemplo, para tener dos acciones en el elemento swipe.right, utiliza el siguiente código:
swipe.right: Row {
anchors.right: parent.right
height: parent.height
Label {
id: moveLabel
text: qsTr("Move")
color: "white"
verticalAlignment: Label.AlignVCenter
padding: 12
height: parent.height
SwipeDelegate.onClicked: console.log("Moving...")
background: Rectangle {
color: moveLabel.SwipeDelegate.pressed ? Qt.darker("#ffbf47", 1.1) : "#ffbf47"
}
}
Label {
id: deleteLabel
text: qsTr("Delete")
color: "white"
verticalAlignment: Label.AlignVCenter
padding: 12
height: parent.height
SwipeDelegate.onClicked: console.log("Deleting...")
background: Rectangle {
color: deleteLabel.SwipeDelegate.pressed ? Qt.darker("tomato", 1.1) : "tomato"
}
}
}Fíjate en cómo la asignación « color » en cada elemento « background » califica la propiedad adjunta con el valor « id » de la etiqueta. Esto es importante; el uso de las propiedades adjuntas en un elemento hace que dicho elemento acepte eventos. Supongamos que hubiéramos omitido « id » en el ejemplo anterior:
color: SwipeDelegate.pressed ? Qt.darker("tomato", 1.1) : "tomato"El elemento de fondo Rectangle es un elemento secundario de la etiqueta, por lo que, naturalmente, recibe los eventos antes que ella. En la práctica, esto significa que el color de fondo cambiará, pero el controlador onClicked de la etiqueta nunca se activará.
Para los controles interactivos (como Button) declarados en estos elementos, utilice en su lugar su respectiva propiedad pressed.
Para pulsaciones sobre el propio SwipeDelegate, utilice su propiedad pressed.
Esta propiedad se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Véase también clicked().
Documentación de señales
[since QtQuick.Controls 2.2 (Qt 5.9)] void swipe.closed()
Esta señal se emite cuando se ha deslizado el delegado para cerrarlo y la transición ha finalizado.
Resulta útil para realizar alguna acción al cancelar un deslizamiento. Por ejemplo, puede utilizarse para cancelar la eliminación del delegado de la lista en la que se encuentra.
Nota: El controlador correspondiente es swipe.onClosed.
Esta señal se introdujo en QtQuick.Controls 2.2 (Qt 5.9).
Véase también swipe y swipe.opened().
[since QtQuick.Controls 2.1 (Qt 5.8)] void swipe.completed()
Esta señal se emite cuando « swipe.complete » pasa a ser « true ».
Resulta útil para realizar alguna acción al finalizar un deslizamiento. Por ejemplo, se puede utilizar para eliminar el delegado de la lista en la que se encuentra.
Nota: El controlador correspondiente es swipe.onCompleted.
Esta señal se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Véase también swipe.
[since QtQuick.Controls 2.2 (Qt 5.9)] void swipe.opened()
Esta señal se emite cuando se ha deslizado el delegado para abrirlo y la transición ha finalizado.
Resulta útil para realizar alguna acción una vez finalizado el deslizamiento. Por ejemplo, se puede utilizar para eliminar el delegado de la lista en la que se encuentra.
Nota: El controlador correspondiente es swipe.onOpened.
Esta señal se introdujo en QtQuick.Controls 2.2 (Qt 5.9).
Véase también swipe y swipe.closed().
Documentación adjunta sobre la señal
[attached, since QtQuick.Controls 2.1 (Qt 5.8)] clicked()
Esta señal se puede asociar a un elemento no interactivo declarado en swipe.left, swipe.right o swipe.behind, con el fin de responder a los clics. Solo se puede hacer clic en los elementos cuando swipe.complete es true.
Para los controles interactivos (como Button) declarados en estos elementos, utilice en su lugar su respectiva señal clicked().
Para responder a los clics sobre el propio SwipeDelegate, utiliza su señal clicked().
Nota: Consulte la documentación de pressed para obtener información sobre cómo utilizar correctamente las propiedades relacionadas con los eventos.
Nota: El controlador correspondiente es onClicked.
Esta señal se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Véase también pressed.
Documentación del método
[since QtQuick.Controls 2.1 (Qt 5.8)] void swipe.close()
Este método establece el valor de « position » del deslizamiento en « 0 ». Se activarán todas las animaciones definidas para la posición « x » de « contentItem » y « background ».
Este método se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Véase también swipe y swipe.open().
[since QtQuick.Controls 2.2 (Qt 5.9)] void swipe.open(enumeration side)
Este método establece el « position » del deslizamiento para que se abra desde el « side » especificado.
Valores disponibles:
| Constante | Descripción |
|---|---|
SwipeDelegate.Left | La dirección de deslizamiento ( position ) se establece en 1, lo que hace que el deslizamiento se abra desde la izquierda. Se debe haber especificado swipe.left o swipe.behind; de lo contrario, la llamada se ignora. |
SwipeDelegate.Right | La propiedad ` position ` se establece en ` -1`, lo que hace que el deslizamiento abra desde la derecha. Debe haberse especificado ` swipe.right ` o ` swipe.behind `; de lo contrario, la llamada se ignora. |
Se activarán todas las animaciones definidas para la posición de « x » de « contentItem » y « background ».
Este método se introdujo en QtQuick.Controls 2.2 (Qt 5.9).
Véase también swipe y swipe.close().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.