Informações gerais
GMSAutocompleteTableDataSource oferece uma interface para fornecer previsões de preenchimento automático de local para preencher uma UITableView por meio da implementação dos protocolos UITableViewDataSource e UITableViewDelegate.
GMSAutocompleteTableDataSource foi projetado para ser usado como a fonte de dados para um UISearchDisplayController.
- Observação:
- O uso do UISearchDisplayController foi descontinuado desde o iOS 8. Agora, é recomendado usar o UISearchController com
GMSAutocompleteResultsViewController
para mostrar os resultados de preenchimento automático usando a interface de pesquisa do iOS.
Defina uma instância de GMSAutocompleteTableDataSource como as propriedades searchResultsDataSource e searchResultsDelegate do UISearchDisplayController. Em sua implementação de shouldReloadTableForSearchString, chame sourceTextHasChanged com a string de pesquisa atual.
Use o protocolo de delegação GMSAutocompleteTableDataSourceDelegate
para receber uma notificação quando um lugar for selecionado na lista. Como as previsões de preenchimento automático são carregadas de forma assíncrona, é necessário implementar didUpdateAutocompletePredictions e chamar refreshData na visualização em tabela do UISearchDisplayController.
Funções membro público | |
(tipo de instância) | - init |
Inicializa uma fonte de dados. | |
(void) | — sourceTextHasChanged: |
Notifica a fonte de dados de que o texto de origem para preenchimento automático foi alterado. | |
(void) | clearResults |
Limpar todas as previsões. | |
Propriedades | |
ID do IBOutlet < GMSAutocompleteTableDataSourceDelegate > | delegar |
Delegue ser notificado quando um lugar for selecionado ou a escolha for cancelada. | |
GMSAutocompleteFilter * | autocompleteFilter |
Filtro a ser aplicado às sugestões de preenchimento automático (pode ser nulo). | |
UIColor * | tableCellBackgroundColor |
A cor de fundo das células da tabela. | |
UIColor * | tableCellSeparatorColor |
A cor da linha do separador entre as células da tabela. | |
UIColor * | primaryTextColor |
A cor do texto do nome do resultado nos resultados do preenchimento automático. | |
UIColor * | primaryTextHighlightColor |
A cor usada para destacar o texto correspondente nos resultados do preenchimento automático. | |
UIColor * | secondaryTextColor |
A cor da segunda linha de texto nos resultados do preenchimento automático. | |
UIColor * | tintColor |
A cor da tonalidade aplicada aos controles na visualização de preenchimento automático. | |
GMSPlaceField | placeFields |
O GMSPlaceField para especificar detalhes explícitos de lugar a serem solicitados. |
Documentação da função membro
- (tipo de instância) init |
Inicializa uma fonte de dados.
- (void) sourceTextHasChanged: | (nullable NSString *) | texto |
Notifica a fonte de dados de que o texto de origem para preenchimento automático foi alterado.
Esse método só precisa ser chamado pela linha de execução principal. Chamar esse método de outra linha de execução resultará em um comportamento indefinido. As chamadas para métodos GMSAutocompleteTableDataSourceDelegate
também serão chamadas na linha de execução principal.
Esse método não faz bloqueios.
- Parâmetros:
-
texto O texto parcial a ser preenchido automaticamente.
- (void) clearResults |
Limpar todas as previsões.
- Observação:
- Isso vai chamar os dois métodos delegados abaixo:
didUpdateAutocompletePredictionsForResultsController:
didRequestAutocompletePredictionsForResultsController:
A implementação desse método os chamará de forma síncrona e na ordem.
Documentação da propriedade
- (ID do IBOutlet<GMSAutocompleteTableDataSourceDelegate>) delegar [read, write, assign] |
Delegue ser notificado quando um lugar for selecionado ou a escolha for cancelada.
- (GMSAutocompleteFilter*) autocompleteFilter [read, write, assign] |
Filtro a ser aplicado às sugestões de preenchimento automático (pode ser nulo).
- (UIColor*) tableCellBackgroundColor [read, write, assign] |
A cor de fundo das células da tabela.
- (UIColor*) tableCellSeparatorColor [read, write, assign] |
A cor da linha do separador entre as células da tabela.
- (UIColor*) primaryTextColor [read, write, assign] |
A cor do texto do nome do resultado nos resultados do preenchimento automático.
- (UIColor*) primaryTextHighlightColor [read, write, assign] |
A cor usada para destacar o texto correspondente nos resultados do preenchimento automático.
- (UIColor*) secondaryTextColor [read, write, assign] |
A cor da segunda linha de texto nos resultados do preenchimento automático.
- (UIColor*) tintColor [read, write, assign] |
A cor da tonalidade aplicada aos controles na visualização de preenchimento automático.
- (GMSPlaceField) placeFields [read, write, assign] |
O GMSPlaceField
para especificar detalhes explícitos de lugar a serem solicitados.
O padrão retorna todos os campos disponíveis.