Visão geral
GMSAutocompleteTableDataSource fornece uma interface para fornecer previsões de preenchimento automático de local para preencher um UITableView implementando os protocolos UITableViewDataSource e UITableViewDelegate.
GMSAutocompleteTableDataSource foi desenvolvido para ser usado como a fonte de dados para um UISearchDisplayController.
- Observação:
- O uso do UISearchDisplayController foi suspenso desde o iOS 8. Agora é recomendado usar o UISearchController com
GMSAutocompleteResultsViewControllerpara exibir resultados de preenchimento automático usando a IU de pesquisa do iOS.
Defina uma instância de GMSAutocompleteTableDataSource como as propriedades searchResultsDataSource e searchResultsDelegate do UISearchDisplayController. Na 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 updateData na visualização de tabela do UISearchDisplayController.
Funções públicas de membros | |
| (instancetype) | - init |
| Inicializa uma fonte de dados. | |
| (nulo) | - sourceTextHasChanged: |
| Notifique a fonte de dados de que o texto de origem para preenchimento automático foi alterado. | |
| (nulo) | - clearResults |
| Limpar todas as previsões. | |
Propriedades | |
| ID do IBOutlet < GMSAutocompleteTableDataSourceDelegate > | delegar |
| Delegar para ser notificado quando um lugar for selecionado ou quando a seleção 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 separadora entre as células da tabela. | |
| UIColor * | primaryTextColor |
| A cor do texto do nome do resultado em resultados de preenchimento automático. | |
| UIColor * | primaryTextHighlightColor |
| A cor usada para destacar o texto correspondente nos resultados de preenchimento automático. | |
| UIColor * | secondaryTextColor |
| A cor da segunda linha do texto nos resultados de preenchimento automático. | |
| UIColor * | TintColor (link em inglês) |
| A cor da tonalidade aplicada aos controles na visualização de preenchimento automático. | |
| GMSPlaceField | placeFields. |
O GMSPlaceField para especificar os detalhes explícitos do lugar a serem solicitados. | |
Documentação da função do membro
| - (instancetype) init |
Inicializa uma fonte de dados.
| - (nulo) sourceTextHasChanged: | (NSString anulável *) | texto |
Notifique a fonte de dados de que o texto de origem para preenchimento automático foi alterado.
Esse método só deve ser chamado na linha de execução principal. Chamar esse método de outra linha de execução resultará em comportamento indefinido. As chamadas para os métodos GMSAutocompleteTableDataSourceDelegate também serão chamadas na linha de execução principal.
Esse método não causa bloqueios.
- Parâmetros:
-
texto O texto parcial a ser preenchido automaticamente.
| - (nulo) clearResults |
Limpar todas as previsões.
- Observação:
- Isso chamará os dois métodos delegados abaixo:
didUpdateAutocompletePredictionsForResultsController:didRequestAutocompletePredictionsForResultsController:
A implementação desse método certamente os chamará de maneira síncrona e em ordem.
Documentação da propriedade
- (IBOutlet id<GMSAutocompleteTableDataSourceDelegate>) delegate [read, write, assign] |
Delegar para ser notificado quando um lugar for selecionado ou quando a seleção 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 separadora entre as células da tabela.
- (UIColor*) primaryTextColor [read, write, assign] |
A cor do texto do nome do resultado em resultados de preenchimento automático.
- (UIColor*) primaryTextHighlightColor [read, write, assign] |
A cor usada para destacar o texto correspondente nos resultados de preenchimento automático.
- (UIColor*) secondaryTextColor [read, write, assign] |
A cor da segunda linha do texto nos resultados de 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 os detalhes explícitos do lugar a serem solicitados.
O padrão retorna todos os campos disponíveis.