GMSAutocompleteFetcher 類別參考資料

GMSAutocompleteFetcher 類別參考資料

總覽

GMSAutocompleteFetcher 是較低階自動完成 API 的包裝函式,其內會封裝使用者輸入內容時要求自動完成預測的複雜性。

呼叫 sourceTextHasChanged 時,通常會導致系統呼叫提供的委派,並針對查詢的文字提供預測查詢字串,並具備以下概念:

  • 如果短時間內發出多次要求,擷取器不一定會要求預測每個 sourceTextHasChanged。
  • 只有在最近呼叫 sourceTextHasChanged 中所提供文字的預測結果時,才會搭配預測結果呼叫委派。

公開成員函式

(執行個體類型)- initWithFilter:
 初始化擷取器。
(void) - provideSessionToken:
 提供 GMSAutocompleteSessionToken 以追蹤特定的自動完成查詢流程。
(void) - sourceTextHasChanged:
 通知擷取器,要自動完成的來源文字已變更。

資源

id
< GMSAutocompleteFetcherDelegate >
委派
 接收自動完成預測結果通知的委派代表。
GMSAutocompleteFilterautocompleteFilter
 篩選出來套用至自動完成建議的項目 (可以設為 nil)。

成員函式說明文件

- (instancetype) initWithFilter: (可為空值 GMSAutocompleteFilter *) 篩選器

初始化擷取器。

參數:
過濾器要套用至結果的篩選器。這個參數可以是 nil。
- (void) provideSessionToken: (可為空值 GMSAutocompleteSessionToken *) sessionToken

提供 GMSAutocompleteSessionToken 以追蹤特定的自動完成查詢流程。

- (void) sourceTextHasChanged: (nullable NSString *)  文字

通知擷取器,要自動完成的來源文字已變更。

這個方法只能從主執行緒呼叫。從其他執行緒呼叫此方法會導致未定義的行為。系統也會在主執行緒上呼叫 GMSAutocompleteFetcherDelegate 方法。

這個方法屬於非阻塞式做法。

參數:
text要自動完成的部分文字。

屬性說明文件

- (id<GMSAutocompleteFetcherDelegate>) 委派 [read, write, assign]

接收自動完成預測結果通知的委派代表。

- (GMSAutocompleteFilter*) autocompleteFilter [read, write, assign]

篩選出來套用至自動完成建議的項目 (可以設為 nil)。