Présentation
GMSAutocompleteTableDataSource fournit une interface qui fournit des prédictions de saisie semi-automatique du lieu afin de renseigner un élément UITableView en implémentant les protocoles UITableViewDataSource et UITableViewDebug.
GMSAutocompleteTableDataSource est conçu pour être utilisé comme source de données pour un UISearchDisplayController.
- Remarque :
- UISearchDisplayController est obsolète depuis iOS 8. Il est maintenant recommandé d'utiliser UISearchController avec
GMSAutocompleteResultsViewController
pour afficher les résultats de la saisie semi-automatique à l'aide de l'UI de recherche iOS.
Définissez une instance de GMSAutocompleteTableDataSource en tant que propriétés searchResultsDataSource et searchResultsDebug 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 saisie semi-automatique se chargent de manière asynchrone, il est nécessaire d'implémenter DidUpdateAutocompletePredictions et d'appeler " reloadData" dans la vue de table de UISearchDisplayController.
Fonctions de membre public | |
(type d'instance) | - init |
Initialise une source de données. | |
(void) | - sourceTextHasChanged: |
Indique à la source de données que le texte source de la saisie semi-automatique a été modifié. | |
(void) | – clearResults |
Effacez toutes les prédictions. | |
Propriétés | |
ID IBOutlet < GMSAutocompleteTableDataSourceDelegate > | délégué |
Déléguez l'envoi d'une notification lorsqu'un lieu est sélectionné ou que la sélection est annulée. | |
GMSAutocompleteFilter * | autocompleteFilter |
Filtre à appliquer aux suggestions de saisie semi-automatique (il peut être nul). | |
UIColor * | tableCellBackgroundColor |
Couleur d'arrière-plan des cellules du tableau. | |
UIColor * | tableCellSeparatorColor |
Couleur de la ligne de séparation entre les cellules du tableau. | |
UIColor * | primaryTextColor |
Couleur du texte du nom du résultat dans les 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 de saisie semi-automatique. | |
GMSPlaceField | placeFields |
GMSPlaceField permettant de spécifier des détails explicites sur le lieu à demander. |
Documentation sur la fonction de membre
- (type d'instance) init |
Initialise une source de données.
- (void) sourceTextHasChanged: | (nullable NSString *) | texte |
Indique à la source de données que le texte source de la saisie semi-automatique a été modifié.
Cette méthode ne doit être appelée qu'à partir du thread principal. L'appel de cette méthode à partir d'un autre thread entraînera un comportement indé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 à saisie semi-automatique.
- (void) clearResults |
Effacez toutes les prédictions.
- Remarque :
- Cette opération appelle les deux méthodes déléguées ci-dessous:
didUpdateAutocompletePredictionsForResultsController:
didRequestAutocompletePredictionsForResultsController:
L'implémentation de cette méthode garantit que ces appels seront appelés de manière synchrone et dans l'ordre.
Documentation de la propriété
- (IBOutlet id<GMSAutocompleteTableDataSourceDelegate>) délégué [read, write, assign] |
Déléguez l'envoi d'une notification lorsqu'un lieu est sélectionné ou que la sélection est annulée.
- (GMSAutocompleteFilter*) autocompleteFilter [read, write, assign] |
Filtre à appliquer aux suggestions de saisie semi-automatique (il peut être nul).
- (UIColor*) tableCellBackgroundColor [read, write, assign] |
Couleur d'arrière-plan des cellules du tableau.
- tableCellSeparatorColor (UIColor*) [read, write, assign] |
Couleur de la ligne de séparation entre les cellules du tableau.
- (UIColor*) primaryTextColor [read, write, assign] |
Couleur du texte du nom du résultat dans les 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.
- tintColor (UIColor*) [read, write, assign] |
Couleur de la teinte appliquée aux commandes de la vue de saisie semi-automatique.
- (GMSPlaceField) placeFields [read, write, assign] |
GMSPlaceField
permettant de spécifier des détails explicites sur le lieu à demander.
La valeur par défaut renvoie tous les champs disponibles.