總覽
GMSAutocompleteTableDataSource 提供介面,可讓您在實作 UITableViewDataSource 和 UITableViewDelegate 通訊協定時,提供地點自動完成預測來填入 UITableView。
GMSAutocompleteTableDataSource 旨在做為 UISearchDisplayController 的資料來源。
- 注意:
- 自 iOS 8 版起,UISearchDisplayController 已淘汰。建議您搭配
GMSAutocompleteResultsViewController
使用 UISearchController,以透過 iOS 搜尋 UI 顯示自動完成結果。
將 GMSAutocompleteTableDataSource 的執行個體設為 UISearchDisplayController 的 searchResultsDataSource 和 searchResultsDelegate 屬性。在實作 重新載入 TableForSearchString 後,使用目前的搜尋字串呼叫 sourceTextHasChanged。
使用 GMSAutocompleteTableDataSourceDelegate
委派通訊協定,即可在選取地點的地點時收到通知。由於自動完成功能是以非同步方式載入,因此您必須在
公開成員函式 | |
(執行個體類型) | - init |
初始化資料來源。 | |
(無效) | - sourceTextHasChanged: |
通知資料來源指出,自動完成文字來源已變更。 | |
(無效) | - clearResults |
清除所有預測查詢字串。 | |
屬性 | |
IBOutlet ID < GMSAutocompleteTableDataSourceDelegate > | 委派 |
有人選取地點或選擇地點時,要通知的委派對象。 | |
GMSAutocompleteFilter * | AutocompleteFilter |
篩選以套用至自動完成建議 (可為零)。 | |
UIColor * | 表格儲存格背景顏色 |
表格儲存格的背景顏色。 | |
UIColor * | tableCellSeparatorColor |
表格儲存格之間的分隔符顏色。 | |
UIColor * | primaryText 顏色 |
自動完成結果中結果名稱的顏色。 | |
UIColor * | 主文字醒目顯示顏色 |
用來在自動完成結果中醒目顯示相符文字的顏色。 | |
UIColor * | 次要文字顏色 |
自動完成結果中第二行文字的顏色。 | |
UIColor * | 色調顏色 |
「自動完成」檢視畫面中控制項套用的色調顏色。 | |
GMSPlaceField | placeFields |
用於指定要求明確地點詳細資料的 GMSPlaceField 。 |
成員函式說明文件
- (執行個體類型) init |
初始化資料來源。
- (無效) sourceTextHasChanged: | (可為空值的 NSString *) | 文字 |
通知資料來源指出,自動完成文字來源已變更。
這個方法只能從主執行緒呼叫。從其他執行緒呼叫此方法會導致未定義的行為。GMSAutocompleteTableDataSourceDelegate
方法的呼叫也會透過主執行緒呼叫。
這種方法不遭到封鎖。
- 參數:
-
傳簡訊給 要自動完成的部分文字。
- (忽略) 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
。
預設會傳回所有可用欄位。