SwipeView QML Type
Permite al usuario navegar por las páginas deslizando el dedo hacia los lados. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- horizontal : bool
(since QtQuick.Controls 2.3 (Qt 5.10)) - interactive : bool
(since QtQuick.Controls 2.1 (Qt 5.8)) - orientation : enumeration
(since QtQuick.Controls 2.2 (Qt 5.9)) - vertical : bool
(since QtQuick.Controls 2.3 (Qt 5.10))
Propiedades adjuntas
- index : int
- isCurrentItem : bool
- isNextItem : bool
(since QtQuick.Controls 2.1 (Qt 5.8)) - isPreviousItem : bool
(since QtQuick.Controls 2.1 (Qt 5.8)) - view : SwipeView
Descripción detallada
SwipeView ofrece un modelo de navegación basado en el deslizamiento.
SwipeView se rellena con un conjunto de páginas. Solo se muestra una página a la vez. El usuario puede navegar entre las páginas deslizando el dedo lateralmente. Ten en cuenta que SwipeView en sí mismo no es visual en absoluto. Se recomienda combinarlo con PageIndicator para dar al usuario una pista visual de que hay varias páginas.
SwipeView {
id: view
currentIndex: 1
anchors.fill: parent
Item {
id: firstPage
}
Item {
id: secondPage
}
Item {
id: thirdPage
}
}
PageIndicator {
id: indicator
count: view.count
currentIndex: view.currentIndex
anchors.bottom: view.bottom
anchors.horizontalCenter: parent.horizontalCenter
}Como se muestra arriba, SwipeView suele contenerse con un conjunto estático de páginas que se definen en línea como elementos secundarios de la vista. También es posible utilizar add, insert, move y remove para cargar páginas de forma dinámica en tiempo de ejecución.
Cuando SwipeView se combina con otro contenedor, como TabBar, es necesario establecer un enlace bidireccional entre la propiedad currentIndex de cada control. Para hacerlo sin romper los enlaces, evita establecer currentIndex directamente y, en su lugar, utiliza setCurrentIndex(), por ejemplo. Consulta Managing the Current Index para obtener más información.
Para realizar una acción cuando cambia « currentIndex », utiliza el controlador de señales de cambio de la propiedad « onCurrentIndexChanged »:
onCurrentIndexChanged: {
print("currentIndex changed to", currentIndex)
// ...
}Por lo general, no es recomendable añadir un número excesivo de páginas a un SwipeView. Sin embargo, cuando el número de páginas aumenta o las páginas individuales son relativamente complejas, puede resultar conveniente liberar recursos descargando las páginas que se encuentran fuera del alcance inmediato del usuario. El siguiente ejemplo muestra cómo utilizar ` Loader ` para mantener un máximo de tres páginas instanciadas simultáneamente.
SwipeView {
Repeater {
model: 6
Loader {
active: SwipeView.isCurrentItem || SwipeView.isNextItem || SwipeView.isPreviousItem
sourceComponent: Text {
text: index
Component.onCompleted: console.log("created:", index)
Component.onDestruction: console.log("destroyed:", index)
}
}
}
}Nota: SwipeView se encarga de la gestión de la geometría de los elementos añadidos a la vista. No se admite el uso de anclajes en los elementos, y cualquier asignación de ` width ` o ` height ` será anulada por la vista. Ten en cuenta que esto solo se aplica a la raíz del elemento. Especificar el ancho y la altura, o utilizar anclajes para sus elementos hijos, funciona como se espera.
Véase también TabBar, PageIndicator, Personalización de SwipeView, Controles de navegación, Controles contenedor y Gestión del foco en los controles de Qt Quick .
Documentación de propiedades
horizontal : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]
Esta propiedad indica si la vista de deslizamiento es horizontal.
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también orientation.
interactive : bool [since QtQuick.Controls 2.1 (Qt 5.8)]
Esta propiedad indica si el usuario puede interactuar con SwipeView. El usuario no puede deslizar el dedo por una vista que no sea interactiva.
El valor por defecto es true.
Esta propiedad se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
orientation : enumeration [since QtQuick.Controls 2.2 (Qt 5.9)]
Esta propiedad define la orientación.
Valores posibles:
| Constante | Descripción |
|---|---|
Qt.Horizontal | Horizontal (por defecto) |
Qt.Vertical | Vertical |
Esta propiedad se introdujo en QtQuick.Controls 2.2 (Qt 5.9).
Véase también horizontal y vertical.
vertical : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]
Esta propiedad indica si la vista de deslizamiento es vertical.
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también orientation.
Documentación de la propiedad adjunta
SwipeView.index : int [read-only attached]
Esta propiedad adjunta contiene el índice de cada elemento secundario de la propiedad « SwipeView ».
Se adjunta a cada elemento secundario del « SwipeView ».
SwipeView.isCurrentItem : bool [read-only attached]
Esta propiedad asociada es « true » si este elemento secundario es el elemento actual.
Se adjunta a cada elemento secundario de la SwipeView.
SwipeView.isNextItem : bool [read-only attached, since QtQuick.Controls 2.1 (Qt 5.8)]
Esta propiedad asociada es « true » si este elemento secundario es el siguiente elemento.
Se asocia a cada elemento secundario de la « SwipeView ».
Esta propiedad se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
SwipeView.isPreviousItem : bool [read-only attached, since QtQuick.Controls 2.1 (Qt 5.8)]
Esta propiedad asociada es « true » si este elemento secundario es el elemento anterior.
Se asocia a cada elemento secundario de SwipeView.
Esta propiedad se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
SwipeView.view : SwipeView [read-only attached]
Esta propiedad asociada contiene la vista que gestiona este elemento secundario.
Se adjunta a cada elemento secundario de « SwipeView ».
© 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.