GMSAutocompleteTableDataSource 類別參考資料

GMSAutocompleteTableDataSource 類別參考資料

總覽

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 >
委派
 委派代表選擇地點或已取消地點時接收通知。
GMSAutocompleteFilterAutocompleteFilter
 套用至自動完成建議的篩選器 (可以是空值)。
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,用於指定要要求的明確地點詳細資料。

預設值會傳回所有可用的欄位。