PlaceSearchSuggestionModel QML Type
Ofrece acceso a sugerencias de términos de búsqueda. Más...
| Import Statement: | import QtLocation 6.12 |
| Since: | QtLocation 5.5 |
Propiedades
- limit : int
- offset : int
- plugin : Plugin
- searchArea : geoShape
- searchTerm : string
- status : enum
- suggestions : stringlist
Métodos
- void cancel()
- string errorString()
- void reset()
- void update()
Descripción detallada
El modelo PlaceSearchSuggestionModel se puede utilizar para ofrecer sugerencias de términos de búsqueda a medida que el usuario introduce su término de búsqueda. Las propiedades de este modelo deben coincidir con las del modelo PlaceSearchModel, que se utilizará para realizar la consulta de búsqueda propiamente dicha, con el fin de garantizar que los resultados de las sugerencias de búsqueda sean relevantes.
Hay dos formas de acceder a los datos proporcionados por este modelo: a través de la propiedad ` suggestions ` o mediante vistas y delegados. Se recomienda utilizar este último método.
Las propiedades « offset » y « limit » pueden utilizarse para acceder a sugerencias paginadas. Cuando se establecen las propiedades « offset » y « limit », se devolverán las sugerencias comprendidas entre « offset » y «(offset + limit - 1)». La compatibilidad con la paginación puede variar de un complemento a otro.
El modelo devuelve datos para los siguientes roles:
| Rol | Tipo | Descripción |
|---|---|---|
| sugerencia | cadena | Término de búsqueda sugerido. |
El siguiente ejemplo muestra cómo utilizar el PlaceSearchSuggestionModel para obtener términos de búsqueda sugeridos a partir de un término de búsqueda parcial. El searchArea se configura para que coincida con lo que se utilizaría para realizar la búsqueda real de lugares con PlaceSearchModel.
import QtQuick
import QtPositioning
import QtLocation
PlaceSearchSuggestionModel {
id: suggestionModel
plugin: myPlugin
// Brisbane
searchArea: QtPositioning.circle(QtPositioning.coordinate(-27.46778, 153.02778))
onSearchTermChanged: update()
}
ListView {
model: suggestionModel
delegate: Text { text: suggestion }
}Véase también PlaceSearchModel y QPlaceManager.
Documentación de propiedades
limit : int
Esta propiedad establece el límite del número de elementos que se devolverán.
Véase también offset.
offset : int
Esta propiedad contiene el índice del primer elemento del modelo.
Véase también limit.
plugin : Plugin
Esta propiedad contiene el proveedor Plugin, que se utilizará para realizar la búsqueda.
searchArea : geoShape
Esta propiedad define el área de búsqueda. Los resultados de las sugerencias de búsqueda que devuelva el modelo serán relevantes para el área de búsqueda especificada.
Si esta propiedad se establece en un « geoCircle », su propiedad « radius » puede dejarse sin definir; en ese caso, el « Plugin » elegirá un radio adecuado para la búsqueda.
searchTerm : string
Esta propiedad contiene el término de búsqueda parcial utilizado en la consulta.
status : enum [read-only]
Esta propiedad contiene el estado del modelo. Puede ser uno de los siguientes:
| PlaceSearchSuggestionModel.Null | No se ha ejecutado ninguna consulta de búsqueda. El modelo está vacío. |
| PlaceSearchSuggestionModel.Ready | La consulta de búsqueda ha finalizado y los resultados están disponibles. |
| PlaceSearchSuggestionModel.Cargando | Actualmente se está ejecutando una consulta de búsqueda. |
| PlaceSearchSuggestionModel.Error | Se ha producido un error al ejecutar la consulta de búsqueda anterior. |
suggestions : stringlist [read-only]
Esta propiedad contiene la lista de términos de búsqueda predichos de los que dispone actualmente el modelo.
Documentación del método
void cancel()
Cancela inmediatamente una operación de sugerencias de búsqueda en curso y establece el estado del modelo en « PlaceSearchSuggestionModel.Ready». El modelo conserva las sugerencias de búsqueda que tenía antes de que se iniciara la operación.
Si no hay ninguna operación en curso, llamar a cancel() no tiene ningún efecto.
Véase también update() y status.
string errorString()
Esta propiedad de solo lectura contiene la representación textual del último error del modelo de sugerencias de búsqueda. Si no se ha producido ningún error, o si se ha borrado el modelo, se devuelve una cadena vacía.
También puede devolverse una cadena vacía si se ha producido un error que no tiene una representación textual asociada.
void reset()
Restablece el modelo. Se borran todas las sugerencias de búsqueda, se cancelan las solicitudes pendientes y se eliminan los posibles errores. El estado del modelo se establecerá en « PlaceSearchSuggestionModel.Null».
void update()
Actualiza el modelo en función de los parámetros de consulta proporcionados. El modelo se completará con una lista de sugerencias de búsqueda para las cadenas parciales searchTerm y searchArea. Si el plugin lo admite, se pueden especificar otros parámetros, como limit y offset. update() envía el conjunto de parámetros a plugin para su procesamiento.
Mientras el modelo se actualiza, el estado « status » del modelo se establece en « PlaceSearchSuggestionModel.Loading ». Si el modelo se actualiza correctamente, el estado « status » se establece en « PlaceSearchSuggestionModel.Ready », mientras que, si la actualización falla, el estado « status » se establece en « PlaceSearchSuggestionModel.Error » y el modelo se borra.
Este ejemplo muestra el uso del modelo
PlaceSeachSuggestionModel {
id: model
plugin: backendPlugin
searchArea: QtPositioning.circle(QtPositioning.coordinate(10, 10))
...
}
MouseArea {
...
onClicked: {
model.searchTerm = "piz"
model.searchArea.center.latitude = -27.5;
model.searchArea.cetner.longitude = 153;
model.update();
}
}Se puede encontrar un ejemplo más detallado en el ejemplo «Places (QML) ».
© 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.