Übersicht
GMSAutocompleteTableDataSource bietet eine Schnittstelle zum Bereitstellen von Place Autocomplete-Vervollständigungen, um eine UITableView auszufüllen, indem die UITableViewDataSource- und UITableViewDelegate-Protokolle implementiert werden.
GMSAutocompleteTableDataSource ist als Datenquelle für einen UISearchDisplayController verwendet.
- Hinweis:
- UISearchDisplayController wird seit iOS 8 eingestellt. Es wird jetzt empfohlen, UISearchController mit
GMSAutocompleteResultsViewControllerzu verwenden, um Ergebnisse der automatischen Vervollständigung über die iOS-Such-UI anzuzeigen.
Legen Sie eine Instanz von GMSAutocompleteTableDataSource als „searchResultsDataSource“- und „searchResultsDelegate“-Properties von UISearchDisplayController fest. Rufen Sie in der Implementierung von „ShouldReloadTableForSearchString“ den Parameter „sourceTextHasChanged“ mit dem aktuellen Suchstring auf.
Mit dem Bevollmächtigten GMSAutocompleteTableDataSourceDelegate für Benachrichtigungen können Sie sich benachrichtigen lassen, wenn ein Ort aus der Liste ausgewählt wird. Weil die automatischen Vervollständigungen asynchron geladen werden, müssen Sie in der Tabellenansicht von UISearchDisplayController die Felder „updateUpdatePredictions“ aktualisieren und „updateData“ aufrufen.
Funktionen für öffentliche Mitglieder | |
| (instancetype) | – init |
| Initialisiert eine Datenquelle. | |
| (ungültig) | – sourceTextHasChanged: |
| Benachrichtigen Sie die Datenquelle darüber, dass sich der Quelltext für die automatische Vervollständigung geändert hat. | |
| (ungültig) | – clearResults |
| Alle Vervollständigungen löschen. | |
Eigenschaften | |
| IBOutlet-ID < GMSAutocompleteTableDataSourceDelegate > | Bevollmächtigung |
| Delegieren, um benachrichtigt zu werden, wenn ein Ort ausgewählt oder ausgewählt wird. | |
| GMSAutocompleteFilter * | AutocompleteFilter |
| Filter, der auf Vorschläge der automatischen Vervollständigung angewendet werden soll (kann „nil“ sein). | |
| UI-Farbe * | TabellenzelleHintergrundfarbe |
| Die Hintergrundfarbe von Tabellenzellen. | |
| UI-Farbe * | TabellenzelleSeparatorFarbe |
| Die Farbe der Trennzeichenlinie zwischen Tabellenzellen. | |
| UI-Farbe * | primaryTextColor |
| Die Farbe des Textes des Ergebnisnamens in den Ergebnissen der automatischen Vervollständigung. | |
| UI-Farbe * | primaryTextHighlightColor |
| Die Farbe, mit der übereinstimmender Text in Ergebnissen der automatischen Vervollständigung hervorgehoben wird. | |
| UI-Farbe * | secondaryTextColor |
| Die Farbe der zweiten Textzeile in Ergebnissen der automatischen Vervollständigung. | |
| UI-Farbe * | Färbungsfarbe |
| Die Farbe wird auf Steuerelemente in der Ansicht für die automatische Vervollständigung angewendet. | |
| GMSPlaceField | placeFelder |
Das GMSPlaceField zum Angeben expliziter Ortsdetails, die angefordert werden sollen. | |
Dokumentation zu Mitgliederfunktionen
| – (instancetype) init |
Initialisiert eine Datenquelle.
| – (void) sourceTextHasChanged: | (null-NS-String *) | SMS |
Benachrichtigen Sie die Datenquelle darüber, dass sich der Quelltext für die automatische Vervollständigung geändert hat.
Diese Methode sollte nur aus dem Hauptthread aufgerufen werden. Wenn Sie diese Methode von einem anderen Thread aus aufrufen, führt dies zu einem undefinierten Verhalten. Aufrufe von GMSAutocompleteTableDataSourceDelegate-Methoden werden auch im Hauptthread aufgerufen.
Diese Methode hat keine Blockierung.
- Parameter:
-
Text Der Teiltext, der automatisch vervollständigt werden soll.
| – (void) clearResults |
Alle Vervollständigungen löschen.
- Hinweis:
- Dadurch werden die beiden folgenden Bevollmächtigten aufgerufen:
didUpdateAutocompletePredictionsForResultsController:didRequestAutocompletePredictionsForResultsController:
Die Implementierung dieser Methode wird garantiert synchron und der Reihe nach aufgerufen.
Property-Dokumentation
– (IBOutlet-ID<GMSAutocompleteTableDataSourceDelegate>) delegate [read, write, assign] |
Delegieren, um benachrichtigt zu werden, wenn ein Ort ausgewählt oder ausgewählt wird.
– (GMSAutocompleteFilter*) AutocompleteFilter [read, write, assign] |
Filter, der auf Vorschläge der automatischen Vervollständigung angewendet werden soll (kann „nil“ sein).
– (UIColor*) tableCellHintergrundFarbe [read, write, assign] |
Die Hintergrundfarbe von Tabellenzellen.
– (UIColor*) tableCellSeparatorColor [read, write, assign] |
Die Farbe der Trennzeichenlinie zwischen Tabellenzellen.
– (UIColor*) primaryTextColor [read, write, assign] |
Die Farbe des Textes des Ergebnisnamens in den Ergebnissen der automatischen Vervollständigung.
– (UIColor*) primaryTextHighlightColor [read, write, assign] |
Die Farbe, mit der übereinstimmender Text in Ergebnissen der automatischen Vervollständigung hervorgehoben wird.
– (UIColor*) secondaryTextColor [read, write, assign] |
Die Farbe der zweiten Textzeile in Ergebnissen der automatischen Vervollständigung.
– (UIColor*) tintColor [read, write, assign] |
Die Farbe wird auf Steuerelemente in der Ansicht für die automatische Vervollständigung angewendet.
– (GMSPlaceField) placeFields [read, write, assign] |
Das GMSPlaceField zum Angeben expliziter Ortsdetails, die angefordert werden sollen.
Standardmäßig werden alle verfügbaren Felder zurückgegeben.