Visão geral
GMSAutocompleteTableDataSource oferece uma interface para fornecer previsões de preenchimento automático de locais para preencher uma UITableView implementando os protocolos UITableViewDataSource e UITableViewDelegate.
GMSAutocompleteTableDataSource foi projetado para ser usado como a fonte de dados de um UISearchDisplayController.
- Observação:
- O uso do UISearchDisplayController foi descontinuado desde o iOS 8. Agora é recomendado usar o UISearchController com
GMSAutocompleteResultsViewControllerpara exibir 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úblicas | |
| (instancetype) | init |
| Inicializa uma fonte de dados. | |
| (void) | - sourceTextHasChanged: |
| Notifica a fonte de dados de que o texto de origem para preenchimento automático mudou. | |
| (void) | – clearResults |
| Limpa todas as previsões. | |
Propriedades | |
| ID do IBOutlet < GMSAutocompleteTableDataSourceDelegate > | delegar |
| Delegar ser notificado quando um lugar for selecionado ou a escolha for cancelada. | |
| GMSAutocompleteFilter * | autocompleteFilter |
| Filtro para aplicar à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 de tonalidade aplicada aos controles na visualização de preenchimento automático. | |
| GMSPlaceField | placeFields |
O GMSPlaceField para especificar detalhes explícitos do lugar a serem solicitados. | |
| NSArray< GMSPlaceProperty > * | placeProperties |
O GMSPlaceProperty para especificar detalhes explícitos do 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 mudou.
Esse método só precisa ser chamado na 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 bloqueia.
- Parâmetros:
-
texto O texto parcial para preenchimento automático.
| - (void) clearResults |
Limpa todas as previsões.
- Observação:
- Isso 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] |
Delegar ser notificado quando um lugar for selecionado ou a escolha for cancelada.
- (GMSAutocompleteFilter*) autocompleteFilter [read, write, assign] |
Filtro para aplicar à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 de tonalidade aplicada aos controles na visualização de preenchimento automático.
- (GMSPlaceField) placeFields [read, write, assign] |
O GMSPlaceField para especificar detalhes explícitos do lugar a serem solicitados.
O padrão retorna todos os campos disponíveis.
- (NSArray<GMSPlaceProperty>*) placeProperties [read, write, assign] |
O GMSPlaceProperty para especificar detalhes explícitos do lugar a serem solicitados.
O padrão retorna todas as propriedades disponíveis.