總覽
GMSAutocompleteTableDataSource 提供一個介面,透過實作 UITableViewDataSource 和 UITableViewDelegate 通訊協定,來為 PlaceTableView 填入資料預測結果。
GMSAutocompleteTableDataSource 的設計為 UISearchDisplayController 的資料來源。
- 注意:
- 自 iOS 8 起,UISearchDisplayController 已淘汰。建議您使用 UISearchController 搭配
GMSAutocompleteResultsViewController
,在 iOS 搜尋 UI 中顯示自動完成結果。
將 GMSAutocompleteTableDataSource 的執行個體設為 UISearchDisplayController 的 searchResultsDataSource 和 searchResultsDelegate 屬性。實作 shouldReloadTableForSearchString 時,使用目前的搜尋字串呼叫 sourceTextHasChanged。
請使用 GMSAutocompleteTableDataSourceDelegate
委派通訊協定,在清單中選取地點時接收通知。由於自動完成預測功能是以非同步方式載入,因此您必須在 UISearchDisplayController 的表格檢視畫面上執行 hadUpdateAutocompletePredictions 並呼叫重新載入 Data。
公開成員函式 | |
(instancetype) | - 初始 |
初始化資料來源。 | |
(無效) | - sourceTextHasChanged: |
通知資料來源的文字自動完成功能已變更。 | |
(無效) | - clearResults |
清除所有預測。 | |
屬性 | |
IBOutlet ID < GMSAutocompleteTableDataSourceDelegate > | 委派 |
委派代表選擇地點或已取消地點時接收通知。 | |
GMSAutocompleteFilter * | AutocompleteFilter |
套用至自動完成建議的篩選器 (可以是空值)。 | |
UIColor * | tableCellBackgroundColor |
表格儲存格的背景顏色。 | |
UIColor * | tableCellSeparatorColor |
表格儲存格之間的分隔符顏色。 | |
UIColor * | 主要文字顏色 |
自動完成結果中的結果名稱文字顏色。 | |
UIColor * | 主要文字醒目顯示顏色 |
用於在自動完成結果中醒目顯示相符文字的顏色。 | |
UIColor * | 次要文字顏色 |
自動完成結果中第二列文字的顏色。 | |
UIColor * | 色調 |
於「自動完成」檢視中的控制項套用色調。 | |
GMSPlaceField | 地點欄位 |
GMSPlaceField ,用於指定要要求的明確地點詳細資料。 |
成員函式說明文件
- (instancetype) init |
初始化資料來源。
- (void) sourceTextHasChanged: | (可為空值的 NSString *) | 文字 |
通知資料來源的文字自動完成功能已變更。
這個方法只能從主執行緒呼叫。如果從另一個執行緒呼叫此方法,就會產生未定義的行為。在主執行緒上呼叫 GMSAutocompleteTableDataSourceDelegate
方法。
這個方法不會封鎖。
- 參數:
-
傳簡訊給 要自動完成的部分文字。
- (void) clearResults |
清除所有預測。
- 注意:
- 這項操作會呼叫下列兩個委派方法:
didUpdateAutocompletePredictionsForResultsController:
didRequestAutocompletePredictionsForResultsController:
此方法的實作保證將會同步呼叫這些順序。
資源說明文件
- (IBOutlet ID<GMSAutocompleteTableDataSourceDelegate>) 委派 [read, write, assign] |
委派代表選擇地點或已取消地點時接收通知。
- (GMSAutocompleteFilter*) AutocompleteFilter [read, write, assign] |
套用至自動完成建議的篩選器 (可以是空值)。
- (UIColor*) tableCellBackgroundColor [read, write, assign] |
表格儲存格的背景顏色。
- (UIColor*) tableCellSeparatorColor [read, write, assign] |
表格儲存格之間的分隔符顏色。
- (UIColor*) primaryTextColor [read, write, assign] |
自動完成結果中的結果名稱文字顏色。
- (UIColor*) primaryTextHighlightColor [read, write, assign] |
用於在自動完成結果中醒目顯示相符文字的顏色。
- (UIColor*) secondaryTextColor [read, write, assign] |
自動完成結果中第二列文字的顏色。
- (UIColor*) tintColor [read, write, assign] |
於「自動完成」檢視中的控制項套用色調。
- (GMSPlaceField) placeFields [read, write, assign] |
GMSPlaceField
,用於指定要要求的明確地點詳細資料。
預設值會傳回所有可用的欄位。