Documentation de référence de la classe GMSAutocompleteTableDataSource

Documentation de référence sur la classe GMSAutocompleteTableDataSource

Présentation

L'interface GMSAutocompleteTableDataSource fournit des prédictions de saisie semi-automatique de lieu pour renseigner un élément UITableView. Pour ce faire, implémentez les protocoles UITableViewDataSource et UITableViewMetadata.

GMSAutocompleteTableDataSource est conçu pour être utilisé comme source de données d'un UISearchDisplayController.

Remarque :
UISearchDisplayController est obsolète depuis iOS 8. Il est désormais 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 searchResultsMetadata de UISearchDisplayController. Dans votre implémentation de shouldReloadTableForSearchString, appelez sourceTextHasChanged avec la chaîne de recherche actuelle.

Utilisez le protocole de délégation 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:
 Informe 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 pour être averti lorsqu'un lieu est sélectionné ou que la sélection est annulée.
GMSAutocompleteFilterautocompleteFilter
 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 de séparation entre les cellules du tableau.
UIColor * primaryTextColor
 Couleur du texte saisi dans le nom du résultat dans les résultats de 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 teinte appliquée aux commandes de la vue de saisie semi-automatique.
GMSPlaceFieldplaceFields
 GMSPlaceField permettant de spécifier des détails explicites sur le lieu à demander.
NSArray< GMSPlaceProperty > * placeProperties
 GMSPlaceProperty permettant de spécifier des détails explicites sur le lieu à demander.

Documentation sur les fonctions de membre

- (type d'instance) init

Initialise une source de données.

- (void) sourceTextHasChanged: (nullable NSString *)  texte

Informe 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 :
textTexte partiel à utiliser pour la saisie semi-automatique.
- (void) clearResults

Effacez toutes les prédictions.

Remarque :
Les deux méthodes déléguées ci-dessous seront appelées:
  • didUpdateAutocompletePredictionsForResultsController:
  • didRequestAutocompletePredictionsForResultsController:

L'implémentation de cette méthode les appelle de manière synchrone et dans l'ordre.


Documentation sur la propriété

- (ID IBOutlet<GMSAutocompleteTableDataSourceDelegate>) delegate [read, write, assign]

Déléguez pour être averti 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 (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 de séparation entre les cellules du tableau.

- (UIColor*) primaryTextColor [read, write, assign]

Couleur du texte saisi dans le nom du résultat dans les résultats de 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 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.

- (NSArray<GMSPlaceProperty>*) placeProperties [read, write, assign]

GMSPlaceProperty permettant de spécifier des détails explicites sur le lieu à demander.

La valeur par défaut renvoie toutes les propriétés disponibles.