Übersicht
GMSAutocompleteTableDataSource bietet eine Schnittstelle zur Bereitstellung von automatischen Vervollständigungen von Orten, um eine UITableView zu füllen. Hierzu werden die Protokolle UITableViewDataSource und UITableViewDelegate implementiert.
GMSAutocompleteTableDataSource ist als Datenquelle für einen UISearchDisplayController zu verwenden.
- Hinweis:
- UISearchDisplayController wird seit iOS 8 nicht mehr unterstützt. 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-Eigenschaften von UISearchDisplayController fest. Rufen Sie in Ihrer Implementierung von shouldReloadTableForSearchString "sourceTextHasChanged" mit dem aktuellen Suchstring auf.
Mit dem Delegierungsprotokoll GMSAutocompleteTableDataSourceDelegate können Sie benachrichtigt werden, wenn ein Ort aus der Liste ausgewählt wird. Da die automatischen Vervollständigungen automatisch geladen werden, müssen Sie DidUpdateAutocompletePredictions implementieren und Guthabendaten in der Tabellenansicht von UISearchDisplayController aufrufen.
Funktionen für öffentliche Mitglieder | |
| (Instanztyp) | - init |
| Initialisiert eine Datenquelle. | |
| (void) | – sourceTextHasChanged: |
| Benachrichtigen Sie die Datenquelle darüber, dass sich der Quelltext für die automatische Vervollständigung geändert hat. | |
| (void) | – clearResults |
| Alle Vorhersagen löschen. | |
Eigenschaften | |
| IBOutlet-ID < GMSAutocompleteTableDataSourceDelegate > | delegieren |
| Delegieren Sie, dass Sie benachrichtigt werden, wenn ein Ort ausgewählt oder abgebrochen wird. | |
| GMSAutocompleteFilter* | autocompleteFilter |
| Filter, der auf Vorschläge der automatischen Vervollständigung angewendet werden soll (kann null sein). | |
| UI-Farbe * | TabellenzelleHintergrundfarbe |
| Die Hintergrundfarbe von Tabellenzellen. | |
| UI-Farbe * | tableCellSeparatorColor |
| Die Farbe der Trennzeichenlinie zwischen Tabellenzellen. | |
| UI-Farbe * | primaryTextColor festlegen. |
| Die Farbe des Textes für den Ergebnisnamen in automatisch vervollständigten Ergebnissen. | |
| 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 * | tintColor |
| Die Farbe, die auf die Steuerelemente in der automatischen Vervollständigung angewendet wird. | |
| GMSPlaceField | placeFields |
Die GMSPlaceField zum Angeben expliziter Ortsdetails, die angefragt werden sollen. | |
Dokumentation zu Mitgliederfunktionen
| - (Instanztyp) init |
Initialisiert eine Datenquelle.
| – (void) sourceTextHasChanged: | (nicht zulässiger NSString *) | 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. Der Aufruf dieser Methode aus einem anderen Thread führt zu einem nicht definierten Verhalten. Aufrufe von GMSAutocompleteTableDataSourceDelegate-Methoden werden auch im Hauptthread aufgerufen.
Diese Methode ist nicht blockiert.
- Parameter:
-
Text Der Teiltext, der automatisch vervollständigt werden soll.
| – (void) clearResults |
Alle Vorhersagen löschen.
- Hinweis:
- Hier werden die beiden delegierten Methoden unten aufgerufen:
didUpdateAutocompletePredictionsForResultsController:didRequestAutocompletePredictionsForResultsController:
Die Implementierung dieser Methode führt garantiert zu einer synchronen und der Reihe nach aufgerufenen Methode.
Property-Dokumentation
- (IBOutlet-ID <GMSAutocompleteTableDataSourceDelegate>) delegieren [read, write, assign] |
Delegieren Sie, dass Sie benachrichtigt werden, wenn ein Ort ausgewählt oder abgebrochen wird.
- (GMSAutocompleteFilter*) autocompleteFilter [read, write, assign] |
Filter, der auf Vorschläge der automatischen Vervollständigung angewendet werden soll (kann null sein).
– (UIColor*) tableCellBackgroundColor [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 für den Ergebnisnamen in automatisch vervollständigten Ergebnissen.
– (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, die auf die Steuerelemente in der automatischen Vervollständigung angewendet wird.
- (GMSPlaceField) placeFields [read, write, assign] |
Die GMSPlaceField zum Angeben expliziter Ortsdetails, die angefragt werden sollen.
Standardmäßig werden alle verfügbaren Felder zurückgegeben.