Überblick
GMSAutocompleteTableDataSource bietet eine Schnittstelle zur Bereitstellung von Place Autocomplete-Vorhersagen zum Ausfüllen einer UITableView, indem die Protokolle UITableViewDataSource und UITableViewDelegate implementiert werden.
GMSAutocompleteTableDataSource wurde zur Verwendung als Datenquelle für ein UISearchDisplayController-Element entwickelt.
- Hinweis:
- UISearchDisplayController wird seit iOS 8 eingestellt. Es wird nun empfohlen, UISearchController mit
GMSAutocompleteResultsViewControllerzu verwenden, um Ergebnisse zur automatischen Vervollständigung über die iOS-Such-UI anzuzeigen.
Legen Sie eine Instanz von GMSAutocompleteTableDataSource als die Properties searchResultsDataSource und searchResultsDelegate von UISearchDisplayController fest. Rufen Sie in Ihrer Implementierung von shouldChargingTableForSearchString „sourceTextHasChanged“ mit dem aktuellen Suchstring auf.
Mit dem Delegierungsprotokoll GMSAutocompleteTableDataSourceDelegate werden Sie benachrichtigt, wenn ein Ort aus der Liste ausgewählt wird. Da Vorschläge für die automatische Vervollständigung asynchron geladen werden, ist es erforderlich, "dedUpdateAutocompletePredictions" zu implementieren und "refreshData" in der Tabellenansicht des UISearchDisplayController-Elements aufzurufen.
Öffentliche Mitgliedsfunktionen | |
| (Instanztyp) | init |
| Initialisiert eine Datenquelle. | |
| (void) | – sourceTextHasChanged: |
| Teilt der Datenquelle mit, dass sich der Quelltext für die automatische Vervollständigung geändert hat. | |
| (void) | – clearResults |
| Alle Vervollständigungen löschen. | |
Eigenschaften | |
| IBOutlet-ID < GMSAutocompleteTableDataSourceDelegate > | bevollmächtigen |
| Bevollmächtigen Sie, um benachrichtigt zu werden, wenn ein Ort ausgewählt oder die Auswahl abgebrochen wird. | |
| GMSAutocompleteFilter * | autocompleteFilter |
| Filter, der auf automatisch vervollständigte Vorschläge angewendet werden soll (kann null sein). | |
| UIColor * | tableCellBackgroundColor |
| Hintergrundfarbe von Tabellenzellen | |
| UIColor * | tableCellSeparatorColor |
| Die Farbe der Trennlinie zwischen Tabellenzellen. | |
| UIColor * | primaryTextColor |
| Die Farbe des Ergebnisnamentexts in Ergebnissen der automatischen Vervollständigung. | |
| UIColor * | primaryTextHighlightColor |
| Die Farbe, mit der übereinstimmenden Text in Ergebnissen der automatischen Vervollständigung hervorgehoben wird. | |
| UIColor * | secondaryTextColor |
| Die Farbe der zweiten Zeile mit Text in Ergebnissen der automatischen Vervollständigung. | |
| UIColor * | tintColor |
| Die Färbung, die auf die Steuerelemente in der Ansicht für die automatische Vervollständigung angewendet wird. | |
| GMSPlaceField | placeFields |
Die GMSPlaceField zum Angeben expliziter Ortsdetails, die angefordert werden sollen. | |
| NSArray< GMSPlaceProperty > * | placeProperties |
Die GMSPlaceProperty zum Angeben expliziter Ortsdetails, die angefordert werden sollen. | |
Dokumentation zu Mitgliederfunktionen
| – (Instanztyp) init |
Initialisiert eine Datenquelle.
| - (void) sourceTextHasChanged: | (nullable NSString *) | SMS |
Teilt der Datenquelle mit, dass sich der Quelltext für die automatische Vervollständigung geändert hat.
Diese Methode sollte nur vom Hauptthread aus aufgerufen werden. Der Aufruf dieser Methode aus einem anderen Thread führt zu undefiniertem Verhalten. Aufrufe an GMSAutocompleteTableDataSourceDelegate-Methoden werden auch im Hauptthread aufgerufen.
Diese Methode ist nicht blockierend.
- Parameter:
-
Text Der Teil des Textes, der automatisch vervollständigt werden soll.
| – (void) clearResults |
Alle Vervollständigungen löschen.
- Hinweis:
- Dadurch werden die beiden folgenden Delegate-Methoden aufgerufen:
didUpdateAutocompletePredictionsForResultsController:didRequestAutocompletePredictionsForResultsController:
Durch die Implementierung dieser Methode werden diese synchron und in der richtigen Reihenfolge aufgerufen.
Property-Dokumentation
- (IBOutlet-ID<GMSAutocompleteTableDataSourceDelegate>) delegate [read, write, assign] |
Bevollmächtigen Sie, um benachrichtigt zu werden, wenn ein Ort ausgewählt oder die Auswahl abgebrochen wird.
– (GMSAutocompleteFilter*) autocompleteFilter [read, write, assign] |
Filter, der auf automatisch vervollständigte Vorschläge angewendet werden soll (kann null sein).
– (UIColor*) tableCellBackgroundColor [read, write, assign] |
Hintergrundfarbe von Tabellenzellen
– (UIColor*) tableCellSeparatorColor [read, write, assign] |
Die Farbe der Trennlinie zwischen Tabellenzellen.
– (UIColor*) primaryTextColor [read, write, assign] |
Die Farbe des Ergebnisnamentexts in Ergebnissen der automatischen Vervollständigung.
– (UIColor*) primaryTextHighlightColor [read, write, assign] |
Die Farbe, mit der übereinstimmenden Text in Ergebnissen der automatischen Vervollständigung hervorgehoben wird.
– (UIColor*) secondaryTextColor [read, write, assign] |
Die Farbe der zweiten Zeile mit Text in Ergebnissen der automatischen Vervollständigung.
– (UIColor*) tintColor [read, write, assign] |
Die Färbung, die auf die Steuerelemente in der Ansicht für die automatische Vervollständigung angewendet wird.
- (GMSPlaceField) placeFields [read, write, assign] |
Die GMSPlaceField zum Angeben expliziter Ortsdetails, die angefordert werden sollen.
Standardmäßig werden alle verfügbaren Felder zurückgegeben.
– (NSArray<GMSPlaceProperty>*) placeProperties [read, write, assign] |
Die GMSPlaceProperty zum Angeben expliziter Ortsdetails, die angefordert werden sollen.
Standardmäßig werden alle verfügbaren Eigenschaften zurückgegeben.