QML: tutor de vistas
EL objetivo de estos tutoriales es familiarizarse con la integración de objetos Lista QML en nuestras aplicaciones.
Todos los objetos de ambos ejemplos de este tutor los encontraremos en la carpeta tutores/qml/qml vistas del proyecto de aplicación de vTutor.
En este tutorial veremos las tres vistas básicas para mostrar elementos de un modelo, integrado con la base de datos de Velneo. Las vistas nos permiten posicionar y definir cómo se mostrarán los elementos de un modelo, en este caso registros provenientes de la base de datos de Velneo.
ListView
GridView
El componente ListView de QML nos permite mostrar en una vista en forma de lista los elementos de un modelo. Se trata de un posicionador para elementos de un modelo, define cómo se pintan éstos.
En este ejemplo, el modelo lo proporciona Velneo a partir de una tabla ART_M y se mostrará por cada elemento cierta información y una imagen.
El objeto QML permite definir dos elementos estándar para mostrar la información en QML, Contenido y URL imagen, que en el código QML se indican con las etiquetas display y decoration respectivamente.
Para incluir más información hacemos uso de los UserRoles, que permiten definir tantas etiquetas como queramos, y que se definen como una fórmula que puede hacer uso de campos, funciones, etc. En este caso, y sólo como ejemplo, hemos creado dos, fecha y hora que mostrarán el dato actual haciendo uso de las funciones correspondientes.
Comenzamos con la declaración de la importación de QtQuick 1.0, ya que usaremos sus componentes.
import QtQuick 2.6
Definimos el rectángulo que contendrá el interfaz QML.
Rectangle {
width: parent.width;
height: parent.height
A continuación definimos un componente Component. Esto permite definir un componente propio que puede ser reutilizado. Muchas veces se definirá en un fichero aparte, con el fin de poder ser usado desde múltiples ficheros QML.
En este caso creamos un componente que denominamos delegado que nos permitirá pintar cada elemento que esté en la lista del modelo. Los delegados son un elemento del ListView y otras vistas que definen cómo se muestran elementos que contienen.
En el componente usamos los componentes posicionadores Column y Row. Se denominan posicionadores porque permiten definir cómo se van a colocar los elementos que contienen.
Component {
id: delegado
Item {
id: item
width: parent.width; height: 90
Row {
id: row
width: parent.width
anchors.margins: 10
spacing: 5
Image {
source: decoration; width: 160; height: 90
asynchronous: true
}
Un detalle importante: si queremos mejorar la usabilidad de nuestras aplicaciones debemos aprovechar todas las posibilidades que nos brinda QML para optimizar. En este caso usamos la propiedad asynchronous: true, para hacer que la carga de las imágenes sea en diferido, es decir, que se muestre el interfaz tan pronto como se cree y que las imágenes se vayan cargando en segundo plano, a fin de no paralizar el interfaz al usuario final.
Column {
width: parent.width - 260
Text {
text: display;
color: item.ListView.isCurrentItem ? "red" : "black"
font.bold: true
}
Text {
width: parent.width
text: "<u>Lorem ipsum dolor sit amet</u>, consectetur adipisicing <b>elit</b>, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.";
wrapMode: Text.Wrap
color: item.ListView.isCurrentItem ? "red" : "black"
}
}
Column {
width: 100
Text {
text: fecha;
color: "black"
font.bold: item.ListView.isCurrentItem ? true : false
}
Text {
text: hora;
color: "black"
font.bold: item.ListView.isCurrentItem ? true : false
}
}
}
El componente MouseArea no permiten definir un área en el que el usuario podrá interaccionar. En este caso, cuando el usuario haga clic sobre el elemento llevaremos haremos que se seleccione.
Si el usuario hace doble clic, en ese caso no sólo llevamos la selección si no que emitimos una señal de activado. Veremos en la vista ListView como la señal de activado se envía para que la detecte Velneo y muestre un formulario correspondiente al registro seleccionado.
MouseArea {
id: mouseArea
anchors.fill: parent
focus: true
onClicked: {
listView.currentIndex = index
}
onDoubleClicked: {
listView.currentIndex = index
listView.itemActivated(index)
}
}
}
}
Creamos otro componente que será el que usemos para la selección (highlight). Es el que define cómo se pinta la selección de un elemento de la vista ListView. Además, le incluimos una animación.
Component {
id: seleccion
Rectangle {
width: parent.width; height: 90
color: "lightsteelblue"; radius: 5
y: listView.currentItem.y
Behavior on y {
SpringAnimation {
spring: 3
damping: 0.2
}
}
}
}
Por último definimos la vista ListView que definimos por medio de los componentes que hemos ido creando.
ListView {
id: listView
anchors.fill: parent
model: theListModel
objectName: "theListView"
Para que la vista se alimente del origen que viene de Velneo (la lista de registros de entrada), definimos el modelo theListModel como aquél que alimenta la vista usando el elemento model.
Además, para que esta lista pueda ser gestionada también desde Velneo la definiremos como un objeto y le daremos el nombre theListView: objectName: “theListView”. En un objeto QML podemos tener muchas vistas, pero ésta será la que se gestione desde Velneo.
Para que las señales de Activado y Cambio de selección se envíen a Velneo, además de asignarles el nombre de objeto debemos definirlas en la vista que queremos que las dispare. Podemos gestionar desde Velneo el cambio de selección con la señal correspondiente y lanzar un evento. La señal de activado permite mostrar el formulario correspondiente al registro en curso que esté definido en el objeto QML.
signal itemActivated(int index)
signal selectionChanged(int index)
Tendremos que gestionar qué registro es el seleccionado y lanzar la señal correspondiente. Por ejemplo, en este caso, queremos que cada vez que se cambie la selección en el interfaz, este cambio de selección quede reflejado en la vista. Para ello usamos la señal de QML onCurrentIndexChanged que se dispara cuando hay un cambio para lanzar hacia Velneo la señal selectionChanged.
onCurrentIndexChanged:
{
listView.selectionChanged( listView.currentIndex )
}
El delegado, como habíamos comentado antes, permite definir la forma en que se mostrará cada elemento de la lista. En este caso hacemos uso de un componente previamente definido. Podríamos programarlo aquí, pero es aconsejable encapsular el código y dividirlo para que sea más sencillo y reutilizable.
delegate: delegado
De igual forma hemos hecho la definición de la selección (highlight), en la que indicamos que hacemos uso del componente creado anteriormente.
highlight: seleccion
highlightFollowsCurrentItem: false
focus: true
}
}
Esta vista funciona de igual modo que ListView, pero posiciona los elementos en un casillero, del que podemos gestionar orientación, etc.
A efectos prácticos, podemos sustituir uno por otro y configurar las características propias de de cada vista, sin necesitar realizar más cambios ver la misma lista de otra forma.
Por tanto, para aprovechar mejor el ejemplo, hemos incluido la sincronización de un GridView con un ListView que usaremos para mostrar un único elemento de la lista, haciendo una transición animada desde el GridView al elemento seleccionado que será visible en el ListView.
import QtQuick 2.6
Rectangle {
id:root
width: parent.width
height: parent.height
color: "black"
Aquí definimos el delegado, es decir, cómo se pintará cada elemento de la lista en el GridView.
Usaremos componentes Item, Row, Column, etc., para definir y posicionar los distintos elementos dentro de la celda.
Component {
id: delegado
Item {
width: 100
height: 100
Image {
source: decoration
width: parent.width
height: parent.height
fillMode: "Stretch"
opacity: 0.5
asynchronous: true
}
Text{ text: display; color: "white" }
MouseArea {
anchors.fill: parent
focus: true
onClicked: {
detalle.currentIndex = index
root.state = "vistaDetalle"
}
}
}
}
Aquí definimos el delegado del detalle, es decir, cómo se pintará cada elemento de la lista en el ListView. En realidad, únicamente se mostrará en pantalla uno de los elementos.
Usaremos componentes Grid (no debemos confundir GridView que gestiona una lista de registros, frente a Grid que gestiona una serie de elementos), Row, Column, etc., para definir y posicionar los distintos elementos dentro de la lista.
Component {
id: detalleDelegado
Grid {
id: detalleDelegadoGrid
rows: 3
spacing: 20
width: 500
Row {
Image {
source: decoration
asynchronous: true
width: 320
fillMode: Image.PreserveAspectFit
smooth: true
MouseArea {
id: mouseAreaImage
anchors.fill: parent
focus: true
onClicked: {
listaGrid.currentIndex = index
listaGrid.itemActivated(index)
}
}
}
Column {
Text {
text: display
font.pointSize: 24
color: "white"
}
Text {
text: fecha
font.pointSize: 18
color: "white"
}
Text {
text: hora
font.pointSize: 14
color: "white"
}
}
}
Row {
Text {
text: display
font.pointSize: 8
wrapMode: "Wrap"
color: "white"
}