مرجع فئة GMSAutocompleteTableDataSource

مرجع الفئة GMSAutocompleteTableDataSource

نظرة عامة

توفر GMSAutocompleteTableDataSource واجهة لتوفير تنبؤات الإكمال التلقائي للأماكن من أجل تعبئة UITableView من خلال تنفيذ بروتوكولَي UITableViewDataSource وUITableViewDelegate.

تم تصميم دالة GMSAutocompleteTableDataSource للاستخدام كمصدر بيانات في UISearchDisplayController.

ملاحظة:
تم إيقاف واجهة برمجة التطبيقات UISearchDisplayController نهائيًا منذ نظام iOS 8. ننصح الآن باستخدام واجهة برمجة التطبيقات UISearchController مع GMSAutocompleteResultsViewController لعرض نتائج الإكمال التلقائي باستخدام واجهة مستخدم البحث في نظام التشغيل iOS.

اضبط مثيلاً من GMSAutocompleteTableDataSource كسمتَين searchResultsDataSource وsearchResultsDelegate في UISearchDisplayController. أثناء تنفيذ shouldReloadTableForSearchString، استدعِ sourceTextHasChanged باستخدام سلسلة البحث الحالية.

استخدِم بروتوكول تفويض GMSAutocompleteTableDataSourceDelegate لتلقّي إشعار عند اختيار مكان من القائمة. نظرًا لأنه يتم تحميل توقعات الإكمال التلقائي بشكل غير متزامن، فمن الضروري تنفيذ doUpdateAutocompleteApplyions وتقرير بيانات إعادة تحميل المكالمات في عرض الجدول في UISearchDisplayController.

وظائف الأعضاء العامة

(instancetype)- init
 تعمل على إعداد مصدر البيانات.
(void) - sourceTextHasChanged:
 إعلام مصدر البيانات بأنه تم تغيير نص المصدر المطلوب إكماله تلقائيًا.
(void) - clearResults
 محو جميع التوقعات.

المواقع

معرّف IBOutlet
< GMSAutocompleteTableDataSourceDelegate >
تفويض
 تفويض ليتم إرسال إشعار إليه عند اختيار مكان أو عند إلغاء عملية الاختيار.
GMSAutocompleteFilterautocompleteFilter
 الفلترة لتطبيقه على اقتراحات الإكمال التلقائي (يمكن أن تكون قيمة فارغة).
لون واجهة المستخدم * tableCellBackgroundColor
 لون خلفية خلايا الجدول
لون واجهة المستخدم * tableCellSeparatorColor
 لون الخط الفاصل بين خلايا الجدول.
لون واجهة المستخدم * primaryTextColor
 لون نص اسم النتيجة في نتائج الإكمال التلقائي
لون واجهة المستخدم * primaryTextHighlightColor
 اللون المستخدَم لتمييز النص المطابق في نتائج الإكمال التلقائي.
لون واجهة المستخدم * secondaryTextColor
 لون الصف الثاني من النص في نتائج الإكمال التلقائي
لون واجهة المستخدم * tintColor
 لون اللون الخفيف الذي تم تطبيقه على عناصر التحكّم في عرض الإكمال التلقائي
GMSPlaceFieldplaceFields
 تمثّل هذه السمة GMSPlaceField لتحديد التفاصيل الصريحة للمكان المطلوب طلبه.
NSArray< GMSPlaceProperty > * placeProperties
 تمثّل هذه السمة GMSPlaceProperty لتحديد التفاصيل الصريحة للمكان المطلوب طلبه.

وثائق وظائف الأعضاء

- (instancetype) init

تعمل على إعداد مصدر البيانات.

- (إبطال) sourceTextHasChanged: (nullable NSString *)  نص

إعلام مصدر البيانات بأنه تم تغيير نص المصدر المطلوب إكماله تلقائيًا.

ويجب استدعاء هذه الطريقة من سلسلة التعليمات الرئيسية فقط. سيؤدي استدعاء هذه الطريقة من سلسلة محادثات أخرى إلى سلوك غير محدّد. سيتم أيضًا استدعاء الطلبات إلى طُرق GMSAutocompleteTableDataSourceDelegate في سلسلة المحادثات الرئيسية.

لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:
textالنص الجزئي المطلوب إكماله تلقائيًا.
- (إبطال) 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 لتحديد التفاصيل الصريحة للمكان المطلوب طلبه.

يتم تلقائيًا عرض جميع الحقول المتاحة.

- (NSArray<GMSPlaceProperty>*) placeProperties [read, write, assign]

تمثّل هذه السمة GMSPlaceProperty لتحديد التفاصيل الصريحة للمكان المطلوب طلبه.

يتم عرض جميع السمات المتاحة بشكل تلقائي.