Panoramica
GMSAutocompleteTableDataSource fornisce un'interfaccia per fornire previsioni di completamento automatico dei luoghi per compilare un oggetto UITableView implementando i protocolli UITableViewDataSource e UITableViewDelegate.
GMSAutocompleteTableDataSource è progettato per essere utilizzato come origine dati per un UISearchDisplayController.
- Nota:
- UISearchDisplayController è stato ritirato da iOS 8. Ora è consigliabile utilizzare UISearchController con
GMSAutocompleteResultsViewControllerper visualizzare i risultati del completamento automatico utilizzando l'interfaccia utente di ricerca di iOS.
Imposta un'istanza di GMSAutocompleteTableDataSource come proprietà searchResultsDataSource e searchResultsDelegate di UISearchDisplayController. Nell'implementazione di needReloadTableForSearchString, chiama sourceTextHasChanged con la stringa di ricerca corrente.
Usa il protocollo delegato GMSAutocompleteTableDataSourceDelegate per ricevere una notifica quando un luogo viene selezionato dall'elenco. Poiché le previsioni di completamento automatico vengono caricate in modo asincrono, è necessario implementare didUpdateAutocompletePredictions e chiamare ricaricaData nella visualizzazione tabella UISearchDisplayController.
Funzioni pubbliche dei membri | |
| (instancetype) | - init |
| Inizializza un'origine dati. | |
| (void) | - testofonteHasChanged: |
| Comunica all'origine dati che il testo di origine da completare automaticamente è stato modificato. | |
| (void) | - clearResults |
| Cancella tutte le previsioni. | |
Proprietà | |
| ID IBOutlet < GMSAutocompleteTableDataSourceDelegate > | delegato |
| Delega l'invio di una notifica quando un luogo viene selezionato o l'operazione viene annullata. | |
| GMSAutocompleteFilter * | autocompleteFilter |
| Filtro da applicare ai suggerimenti di completamento automatico (può essere nullo). | |
| UIColor * | tableCellBackgroundColor |
| Il colore di sfondo delle celle della tabella. | |
| UIColor * | tableCellSeparatorColor |
| Il colore della linea separatore tra le celle della tabella. | |
| UIColor * | primaryTextColor |
| Il colore del testo del nome del risultato nei risultati del completamento automatico. | |
| UIColor * | primaryTextHighlightColor |
| Il colore utilizzato per evidenziare il testo corrispondente nei risultati del completamento automatico. | |
| UIColor * | secondaryTextColor |
| Il colore della seconda riga di testo nei risultati del completamento automatico. | |
| UIColor * | tintColor |
| Il colore di tinta applicato ai controlli nella visualizzazione Completamento automatico. | |
| GMSPlaceField | placeFields |
GMSPlaceField per la specifica di dettagli espliciti sul luogo da richiedere. | |
| NSArray< GMSPlaceProperty > * | placeProperties |
GMSPlaceProperty per la specifica di dettagli espliciti sul luogo da richiedere. | |
Documentazione sulle funzioni dei membri
| - (instancetype) init |
Inizializza un'origine dati.
| - (void) sourceTextHasChanged: | (nullable NSString *) | testo |
Comunica all'origine dati che il testo di origine da completare automaticamente è stato modificato.
Questo metodo deve essere chiamato solo dal thread principale. Se chiami questo metodo da un altro thread, il comportamento non sarà definito. Le chiamate ai metodi GMSAutocompleteTableDataSourceDelegate verranno chiamate anche nel thread principale.
Questo metodo non blocca.
- Parametri:
-
testo Il testo parziale da completare automaticamente.
| - (void) clearResults |
Cancella tutte le previsioni.
- Nota:
- Questa operazione chiamerà i due metodi delegati di seguito:
didUpdateAutocompletePredictionsForResultsController:didRequestAutocompletePredictionsForResultsController:
L'implementazione di questo metodo garantisce che le chiamate in modo sincrono e in ordine.
Documentazione della proprietà
- (ID IBOutlet<GMSAutocompleteTableDataSourceDelegate>) delega [read, write, assign] |
Delega l'invio di una notifica quando un luogo viene selezionato o l'operazione viene annullata.
- (GMSAutocompleteFilter*) autocompleteFilter [read, write, assign] |
Filtro da applicare ai suggerimenti di completamento automatico (può essere nullo).
- (UIColor*) tableCellBackgroundColor [read, write, assign] |
Il colore di sfondo delle celle della tabella.
- (UIColor*) tableCellSeparatorColor [read, write, assign] |
Il colore della linea separatore tra le celle della tabella.
- (UIColor*) primaryTextColor [read, write, assign] |
Il colore del testo del nome del risultato nei risultati del completamento automatico.
- (UIColor*) primaryTextHighlightColor [read, write, assign] |
Il colore utilizzato per evidenziare il testo corrispondente nei risultati del completamento automatico.
- (UIColor*) secondaryTextColor [read, write, assign] |
Il colore della seconda riga di testo nei risultati del completamento automatico.
- (UIColor*) tintColor [read, write, assign] |
Il colore di tinta applicato ai controlli nella visualizzazione Completamento automatico.
- (GMSPlaceField) placeFields [read, write, assign] |
GMSPlaceField per la specifica di dettagli espliciti sul luogo da richiedere.
Il valore predefinito restituisce tutti i campi disponibili.
- (NSArray<GMSPlaceProperty>*) placeProperties [read, write, assign] |
GMSPlaceProperty per la specifica di dettagli espliciti sul luogo da richiedere.
Il valore predefinito restituisce tutte le proprietà disponibili.