Überblick
GMSAutocompleteTableDataSource bietet eine Schnittstelle zur Bereitstellung von Place Autocomplete-Vervollständigungen zum Ausfüllen einer UITableView durch Implementierung der UITableViewDataSource- und UITableViewDelegate-Protokolle.
GMSAutocompleteTableDataSource ist zur Verwendung als Datenquelle für ein UISearchDisplayController vorgesehen.
- Hinweis:
- UISearchDisplayController wurde seit iOS 8 eingestellt. Es wird jetzt empfohlen, UISearchController mit
GMSAutocompleteResultsViewController
zu verwenden, um Ergebnisse der 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 der Implementierung von shouldRefreshTableForSearchString mit dem aktuellen Suchstring auf „sourceTextHasChanged“ auf.
Verwenden Sie das Delegatprotokoll GMSAutocompleteTableDataSourceDelegate
, um benachrichtigt zu werden, wenn ein Ort aus der Liste ausgewählt wird. Da Vervollständigungen der automatischen Vervollständigung asynchron geladen werden, ist es erforderlich, "didUpdateAutocompletePredictions" zu implementieren und "refreshData" in der Tabellenansicht des UISearchDisplayController-Elements aufzurufen.
Öffentliche Mitgliederfunktionen | |
(Instanztyp) | init |
Initialisiert eine Datenquelle. | |
(void) | – sourceTextHasChanged: |
Hiermit wird die Datenquelle darüber informiert, dass sich der Quelltext für die automatische Vervollständigung geändert hat. | |
(void) | – clearResults |
Alle Vervollständigungen löschen. | |
Attribute | |
IBOutlet-ID < GMSAutocompleteTableDataSourceDelegate > | bevollmächtigen |
Delegieren 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 wurde. | |
GMSPlaceField | placeFields |
Die GMSPlaceField zum Angeben expliziter Ortsdetails, die angefordert werden sollen. |
Dokumentation zu Mitgliederfunktionen
– (Instanztyp) init |
Initialisiert eine Datenquelle.
- (void) sourceTextHasChanged: | (nullable NSString *) | SMS |
Hiermit wird die Datenquelle darüber informiert, 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 einem undefinierten Verhalten. Aufrufe von GMSAutocompleteTableDataSourceDelegate
-Methoden werden auch im Hauptthread aufgerufen.
Diese Methode blockiert nicht.
- Parameter:
-
Text Der Teiltext, der automatisch vervollständigt werden soll.
– (void) clearResults |
Alle Vervollständigungen löschen.
- Hinweis:
- Dadurch werden die beiden folgenden Delegatmethoden aufgerufen:
didUpdateAutocompletePredictionsForResultsController:
didRequestAutocompletePredictionsForResultsController:
Durch die Implementierung dieser Methode wird garantiert, dass diese synchron und in der richtigen Reihenfolge aufgerufen werden.
Property-Dokumentation
- (IBOutlet-ID<GMSAutocompleteTableDataSourceDelegate>) delegate [read, write, assign] |
Delegieren 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 wurde.
- (GMSPlaceField) placeFields [read, write, assign] |
Die GMSPlaceField
zum Angeben expliziter Ortsdetails, die angefordert werden sollen.
Standardmäßig werden alle verfügbaren Felder zurückgegeben.