GMSAutocompleteTableDataSource-Klassenreferenz

GMSAutocompleteTableDataSource-Klassenreferenz

Ü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.
GMSAutocompleteFilterautocompleteFilter
 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.
GMSPlaceFieldplaceFields
 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:
TextDer 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.