GMSAutocompleteTableDataSource 類別參考資料

Public Member Functions (公開成員函式) | 屬性
GMSAutocompleteTableDataSource 類別參考

總覽

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 >
委派
 有人選取地點或選擇地點時,要通知的委派對象。
GMSAutocompleteFilterAutocompleteFilter
 篩選以套用至自動完成建議 (可為零)。
UIColor * 表格儲存格背景顏色
 表格儲存格的背景顏色。
UIColor * tableCellSeparatorColor
 表格儲存格之間的分隔符顏色。
UIColor * primaryText 顏色
 自動完成結果中結果名稱的顏色。
UIColor * 主文字醒目顯示顏色
 用來在自動完成結果中醒目顯示相符文字的顏色。
UIColor * 次要文字顏色
 自動完成結果中第二行文字的顏色。
UIColor * 色調顏色
 「自動完成」檢視畫面中控制項套用的色調顏色。
GMSPlaceFieldplaceFields
 用於指定要求明確地點詳細資料的 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

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