PlaceSearchSuggestionModel QML Type

Proporciona acceso a sugerencias de términos de búsqueda. Más...

• Lista de todos los miembros, incluidos los heredados

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 PlaceSearchSuggestionModel se puede utilizar para proporcionar 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 de PlaceSearchModel, que se utilizará para realizar la consulta de búsqueda real, para garantizar que los resultados de las sugerencias de búsqueda sean pertinentes.

Hay dos formas de acceder a los datos proporcionados por este modelo, ya sea a través de la propiedad suggestions o a través de vistas y delegados. Este último es el método preferido.

Las propiedades offset y limit pueden utilizarse para acceder a las sugerencias paginadas. Cuando se establecen las propiedades offset y limit se devolverán las sugerencias comprendidas entre offset y (offset + limit - 1). El soporte para la paginación puede variar de un plugin a otro.

El modelo devuelve datos para los siguientes roles:

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. searchArea se configura para que coincida con lo que se utilizaría para realizar la búsqueda de lugares real 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 contiene 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 contiene el área de búsqueda. Los resultados de las sugerencias de búsqueda devueltos por el modelo serán relevantes para el área de búsqueda dada.

Si esta propiedad se establece en geoCircle, su propiedad radius puede dejarse sin establecer, en cuyo caso Plugin elegirá un radio apropiado 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

suggestions : stringlist [read-only]

Esta propiedad contiene la lista de términos de búsqueda previstos que tiene actualmente el modelo.

Documentación del método

void cancel()

Cancela inmediatamente una operación de sugerencia de búsqueda en curso y establece el estado del modelo en PlaceSearchSuggestionModel.Ready. El modelo conserva las sugerencias de búsqueda que tuviera antes de iniciarse la operación.

Si una operación no está en curso, la invocación de cancel() no tiene ningún efecto.

Véase también update() y status.

string errorString()

Esta propiedad de sólo lectura contiene la presentación textual del último error del modelo de sugerencia 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 representación textual asociada.

void reset()

Reinicia el modelo. Se borran todas las sugerencias de búsqueda, se cancelan las solicitudes pendientes y se borran los posibles errores. El estado del modelo será PlaceSearchSuggestionModel.Null.

void update()

Actualiza el modelo basándose en los parámetros de consulta proporcionados. El modelo se rellenará con una lista de sugerencias de búsqueda para los parciales searchTerm y searchArea. Si el plugin lo admite, pueden especificarse otros parámetros como limit y offset. update() envía el conjunto de parámetros al plugin para que los procese.

Mientras el modelo se actualiza, el status del modelo se establece en PlaceSearchSuggestionModel.Loading. Si el modelo se actualiza con éxito, el status se establece en PlaceSearchSuggestionModel.Ready, mientras que si no se completa con éxito, el 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();
    }
}

Puede encontrar un ejemplo más detallado en el ejemplo en Lugares (QML ).

Véase también cancel() y status.