Visão geral
GMSAutocompleteTableDataSource fornece uma interface para fornecer previsões de preenchimento automático de local para preencher uma UITableView implementando os protocolos UITableViewDataSource e UITableViewDelegate.
GMSAutocompleteTableDataSource foi projetado para ser usado como a fonte de dados para um UISearchDisplayController.
- Observação:
- O UISearchDisplayController foi descontinuado desde o iOS 8. Agora é recomendável usar UISearchController com
GMSAutocompleteResultsViewController
para 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 refreshData na visualização em tabela do UISearchDisplayController.
Funções públicas do membro | |
(instancetype) | - init |
Inicializa uma fonte de dados. | |
(vazio) | - sourceTextHasChanged: |
Notifique a fonte de dados de que o texto da fonte para o preenchimento automático mudou. | |
(vazio) | - clearResults |
Limpar todas as previsões. | |
Propriedades | |
ID do IBOutlet < GMSAutocompleteTableDataSourceDelegate > | delegar |
Delegar para ser notificado quando um lugar for selecionado ou a seleção for cancelada. | |
GMSAutocompleteFilter * | AutofillFilter |
Filtro para aplicar às sugestões de preenchimento automático (pode ser nula). | |
IUColor * | tableCellBackgroundColor |
A cor do plano de fundo das células da tabela. | |
IUColor * | tableCellSeparatorColor (link em inglês) |
A cor da linha separadora entre células de tabela. | |
IUColor * | CoreTextTexto |
A cor do texto do nome do resultado nos resultados de preenchimento automático. | |
IUColor * | primaryTextDestacarColor |
A cor usada para destacar o texto correspondente nos resultados do preenchimento automático. | |
IUColor * | secondaryTextColor (em inglês) |
A cor da segunda linha do texto nos resultados de preenchimento automático. | |
IUColor * | tintColor (em inglês) |
A cor da tonalidade aplicada aos controles na visualização de preenchimento automático. | |
GMSPlaceField | placeFields (em inglês) |
O GMSPlaceField para especificar os detalhes explícitos do lugar a serem solicitados. |
Documentação da função de membro
- (instancetype) init |
Inicializa uma fonte de dados.
- (void) sourceTextHasChanged: | (NSString anulável *) | texto |
Notifique a fonte de dados de que o texto da fonte para o preenchimento automático mudou.
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 um 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 que será preenchido automaticamente.
- (vazio) 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 tem a garantia de chamá-los 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 a seleção for cancelada.
- (GMSAutocompleteFilter*) completionFilter [read, write, assign] |
Filtro para aplicar às sugestões de preenchimento automático (pode ser nula).
- (UIColor*) tableCellBackgroundColor [read, write, assign] |
A cor do plano de fundo das células da tabela.
- (UIColor*) tableCellSeparatorColor [read, write, assign] |
A cor da linha separadora entre células de tabela.
- (UIColor*) primaryTextColor [read, write, assign] |
A cor do texto do nome do resultado nos resultados de 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 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.