Présentation
GMSAutocompleteTableDataSource fournit une interface qui permet de fournir des prédictions de saisie semi-automatique de lieu afin de renseigner un UITableView en implémentant les protocoles UITableViewDataSource et UITableViewDelegate.
GMSAutocompleteTableDataSource est conçu pour être utilisé comme source de données pour UISearchDisplayController.
- Remarque :
- UISearchDisplayController est obsolète depuis iOS 8. Il est maintenant recommandé d'utiliser UISearchController avec
GMSAutocompleteResultsViewControllerpour afficher les résultats de la saisie semi-automatique dans l'UI de recherche iOS.
Définissez une instance de GMSAutocompleteTableDataSource en tant que propriétés searchResultsDataSource et searchResultsDelegate de UISearchDisplayController. Dans votre implémentation de shouldReloadTableForSearchString, appelez sourceTextHasChanged avec la chaîne de recherche actuelle.
Utilisez le protocole délégué GMSAutocompleteTableDataSourceDelegate pour être averti lorsqu'un lieu est sélectionné dans la liste. Étant donné que les prédictions de la saisie semi-automatique se chargent de manière asynchrone, il est nécessaire d'implémenter DidUpdateAutocompletePredictions et d'appeler reloadData sur la vue Tableau de UISearchDisplayController.
Fonctions publiques | |
| (type d'instance) | - init |
| Initialise une source de données. | |
| (void) | - sourceTextHasChanged: |
| Indique à la source de données que le texte source correspondant à la saisie semi-automatique a été modifié. | |
| (void) | - clearResults. |
| Effacer toutes les prédictions. | |
Propriétés | |
| IBOutlet ID < GMSAutocompleteTableDataSourceDelegate > | délégué |
| Déléguez des notifications lorsqu'un lieu est sélectionné ou qu'il est annulé. | |
| GMSAutocompleteFilter * | completeFilter |
| Filtre à appliquer aux suggestions de saisie semi-automatique (peut être nul). | |
| UIColor * | tableCellBackgroundColor |
| Couleur d'arrière-plan des cellules du tableau. | |
| UIColor * | tableCellSeparatorColor |
| Couleur de la ligne du séparateur entre les cellules du tableau. | |
| UIColor * | primaryTextColor. |
| Couleur du texte du nom des résultats de la saisie semi-automatique. | |
| UIColor * | primaryTextHighlightColor |
| Couleur utilisée pour mettre en surbrillance le texte correspondant dans les résultats de la saisie semi-automatique. | |
| UIColor * | secondaryTextColor |
| Couleur de la deuxième ligne de texte dans les résultats de la saisie semi-automatique. | |
| UIColor * | TintColor |
| Couleur de la teinte appliquée aux commandes de la vue Autocomplete. | |
| GMSPlaceField | placesChamps |
Le GMSPlaceField permettant de spécifier des détails de lieu explicites à demander. | |
Documentation sur la fonction de membre
| - (type d'instance) init |
Initialise une source de données.
| - (void) sourceTextHasChanged: | (null Chaîne nullable *) | texte |
Indique à la source de données que le texte source correspondant à la saisie semi-automatique a été modifié.
Cette méthode ne doit être appelée qu'à partir du thread principal. Appeler cette méthode à partir d'un autre thread entraînera un comportement non défini. Les appels aux méthodes GMSAutocompleteTableDataSourceDelegate seront également appelés sur le thread principal.
Cette méthode est non bloquante.
- Paramètres :
-
text Texte partiel à utiliser pour la saisie semi-automatique.
| - (void) clearResults |
Effacer toutes les prédictions.
- Remarque :
- Cette opération appelle les deux méthodes de délégation ci-dessous:
didUpdateAutocompletePredictionsForResultsController:didRequestAutocompletePredictionsForResultsController:
L'implémentation de cette méthode permet de les appeler de manière synchrone et dans l'ordre.
Documentation sur la propriété
- (IBOutlet id<GMSAutocompleteTableDataSourceDelegate>) délégué [read, write, assign] |
Déléguez des notifications lorsqu'un lieu est sélectionné ou qu'il est annulé.
– (GMSAutocompleteFilter*) completeFilter [read, write, assign] |
Filtre à appliquer aux suggestions de saisie semi-automatique (peut être nul).
- (UIColor*) tableCellBackgroundColor [read, write, assign] |
Couleur d'arrière-plan des cellules du tableau.
- (UIColor*) tableCellSeparatorColor [read, write, assign] |
Couleur de la ligne du séparateur entre les cellules du tableau.
- (UIColor*) primaryTextColor [read, write, assign] |
Couleur du texte du nom des résultats de la saisie semi-automatique.
- (UIColor*) primaryTextHighlightColor [read, write, assign] |
Couleur utilisée pour mettre en surbrillance le texte correspondant dans les résultats de la saisie semi-automatique.
- (UIColor*) secondaryTextColor [read, write, assign] |
Couleur de la deuxième ligne de texte dans les résultats de la saisie semi-automatique.
- (UIColor*) tintColor [read, write, assign] |
Couleur de la teinte appliquée aux commandes de la vue Autocomplete.
- (GMSPlaceField) placeFields [read, write, assign] |
Le GMSPlaceField permettant de spécifier des détails de lieu explicites à demander.
La valeur par défaut renvoie tous les champs disponibles.