بررسی اجمالی
GMSAutocompleteTableDataSource با پیاده سازی پروتکل های UITableViewDataSource و UITableViewDelegate، یک رابط برای ارائه پیش بینی های تکمیل خودکار مکان برای پر کردن UITableView فراهم می کند.
GMSAutocompleteTableDataSource برای استفاده به عنوان منبع داده برای UISearchDisplayController طراحی شده است.
- توجه داشته باشید:
- UISearchDisplayController از iOS 8 منسوخ شده است. اکنون توصیه می شود از UISearchController با
GMSAutocompleteResultsViewControllerبرای نمایش نتایج تکمیل خودکار با استفاده از رابط کاربری جستجوی iOS استفاده کنید.
یک نمونه از GMSAutocompleteTableDataSource را به عنوان searchResultsDataSource و searchResultsDelegate ویژگی های UISearchDisplayController را تنظیم کنید. در اجرای shouldReloadTableForSearchString، sourceTextHasChanged را با رشته جستجوی فعلی فراخوانی کنید.
از پروتکل نماینده GMSAutocompleteTableDataSourceDelegate استفاده کنید تا زمانی که مکانی از لیست انتخاب می شود مطلع شوید. از آنجایی که پیش‌بینی‌های تکمیل خودکار به‌صورت ناهمزمان بارگیری می‌شوند، لازم است didUpdateAutocompletePredictions را پیاده‌سازی کنید و reloadData را در نمای جدول UISearchDisplayController فراخوانی کنید.
توابع اعضای عمومی | |
| (نوع نمونه) | - شروع |
| یک منبع داده را راه اندازی می کند. | |
| (خالی) | - sourceTextHasChanged: |
| به منبع داده اطلاع دهید که متن منبع برای تکمیل خودکار تغییر کرده است. | |
| (خالی) | - نتایج واضح |
| تمام پیش بینی ها را پاک کنید. | |
خواص | |
| شناسه IBOoutlet < GMSAutocompleteTableDataSourceDelegate > | نماینده |
| وقتی مکانی انتخاب شد یا انتخاب لغو شد، به شما اطلاع داده شود. | |
| GMSAutocompleteFilter * | تکمیل خودکار فیلتر |
| فیلتر برای اعمال به پیشنهادات تکمیل خودکار (می تواند صفر باشد). | |
| UIColor * | tableCellBackgroundColor |
| رنگ پس زمینه سلول های جدول. | |
| UIColor * | tableCellSeparatorColor |
| رنگ خط جداکننده بین سلول های جدول. | |
| UIColor * | PrimeTextColor |
| رنگ متن نام نتیجه در نتایج تکمیل خودکار. | |
| UIColor * | primarTextHighlightColor |
| رنگ مورد استفاده برای برجسته کردن متن منطبق در نتایج تکمیل خودکار. | |
| UIColor * | secondaryTextColor |
| رنگ ردیف دوم متن در نتایج تکمیل خودکار. | |
| UIColor * | tintColor |
| رنگ ته رنگ اعمال شده روی کنترل ها در نمای تکمیل خودکار. | |
| GMSPlaceField | مکان فیلدها |
GMSPlaceField برای تعیین جزئیات مکان صریح که باید درخواست شود. | |
| NSArray< GMSPlaceProperty > * | مکان خواص |
GMSPlaceProperty برای تعیین جزئیات مکان صریح که باید درخواست شود. | |
مستندات عملکرد اعضا
| - (نمونه) init |
یک منبع داده را راه اندازی می کند.
| - (باطل) sourceTextHasChanged: | (NSString nullable *) | متن |
به منبع داده اطلاع دهید که متن منبع برای تکمیل خودکار تغییر کرده است.
این روش فقط باید از موضوع اصلی فراخوانی شود. فراخوانی این متد از یک رشته دیگر منجر به رفتار نامشخص می شود. تماس با متدهای GMSAutocompleteTableDataSourceDelegate نیز در رشته اصلی فراخوانی خواهد شد.
این روش غیر مسدود کننده است.
- مولفه های:
متن متن جزئی برای تکمیل خودکار.
| - (باطل) نتایج واضح |
تمام پیش بینی ها را پاک کنید.
- توجه داشته باشید:
- با این کار دو روش نمایندگی زیر را فراخوانی می کند:
-
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 برای تعیین جزئیات مکان صریح که باید درخواست شود.
پیش فرض همه فیلدهای موجود را برمی گرداند.
- (NSArray<GMSPlaceProperty>*) placeProperties [read, write, assign] |
GMSPlaceProperty برای تعیین جزئیات مکان صریح که باید درخواست شود.
پیش فرض تمام ویژگی های موجود را برمی گرداند.