مرجع فئة GMSAutocompleteTableDataSource

مرجع فئة GMSAutocompleteTableDataSource

نظرة عامة

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

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

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

اضبط مثيلاً لـ GMSAutocompleteTableDataSource كخاصيتين searchResultsDataSource وsearchResultsدور لـ UISearchDisplayController. في تنفيذك لـ shouldReloadTableForSearchString، استدعِ sourceTextHasChanged باستخدام سلسلة البحث الحالية.

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

وظائف الأعضاء العامين

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

المواقع

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

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

- (instancetype) init

يقوم بتهيئة مصدر البيانات.

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

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

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

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

المَعلمات:
textجزء النص المطلوب إكماله تلقائيًا.
- (باطل) clearResults

محو جميع التوقّعات

ملاحظة:
سيؤدي ذلك إلى استدعاء طريقتَي التفويض أدناه:
  • didUpdateAutocompletePredictionsForResultsController:
  • didRequestAutocompletePredictionsForResultsController:

ويضمن تطبيق هذه الطريقة استدعاء هذه العناصر بشكل متزامن وترتيب.


وثائق العقار

- (رقم تعريف IBOutlet<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 لتحديد التفاصيل الصريحة للمكان المطلوب طلبها.

يؤدي الإعداد التلقائي إلى عرض جميع الحقول المتاحة.