نظرة عامة
توفر أداة GMScompletionTableDataSource واجهة لتقديم توقعات الإكمال التلقائي للأماكن لتعبئة UITableView من خلال تنفيذ بروتوكول UITableViewDataSource وUITableViewDelegate.
تم تصميم GMScompletionTableDataSource لاستخدامه كمصدر بيانات لـ UISearchDisplayController.
- ملاحظة:
- تم إيقاف واجهة المستخدم SearchSearchDisplayController منذ نظام التشغيل iOS 8. يُنصح الآن باستخدام UISearchController مع
GMSAutocompleteResultsViewControllerلعرض نتائج الإكمال التلقائي باستخدام واجهة مستخدم بحث iOS.
اضبط مثيل GMScompletionTableDataSource كخاصيتين searchResultsDataSource وsearchResultsDelegate لـ UISearchDisplayController. في عملية تنفيذ أمر وينبغي إعادة تحميل الجدول بحث في ForStringString، استدعاء sourceTextHasChanged مع سلسلة البحث الحالية.
استخدِم بروتوكول تفويض GMSAutocompleteTableDataSourceDelegate ليتم إشعارك عند اختيار مكان من القائمة. نظرًا لأن تنبؤات الإكمال التلقائي يتم تحميلها بشكل غير متزامن، فمن الضروري تنفيذ وظيفة updateUpdateCompletePredictions وطلب إعادة تحميل البيانات في عرض الجدول UISearchDisplayController.
وظائف الأعضاء العامين | |
| (مثال) | - init |
| لإعداد مصدر بيانات. | |
| (ملغي) | - sourceTextHasChanged: |
| أبلغ مصدر البيانات بأن النص المصدر المراد إكماله تلقائيًا قد تم تغييره. | |
| (ملغي) | - clearResults |
| محو جميع التوقعات. | |
المواقع | |
| رقم تعريف IBOutlet < GMScompletionTableDataSourceDelegate > | تفويض |
| تفويض ليتم إشعارك عند تحديد مكان أو إلغاء الاختيار. | |
| فلتر الإكمال التلقائي من Google * | autocompleteFilter |
| فلتر لتطبيقه على اقتراحات الإكمال التلقائي (يمكن أن تكون فارغة). | |
| UIColor * | tableCellBackgroundColor |
| لون خلفية خلايا الجدول. | |
| UIColor * | tableCellSeparatorColor |
| لون خط الفاصل بين خلايا الجدول. | |
| UIColor * | primaryTextColor |
| لون نص اسم النتيجة في نتائج الإكمال التلقائي. | |
| UIColor * | primaryTexthighlightColor |
| اللون المستخدم لتمييز النص المتطابق في نتائج الإكمال التلقائي. | |
| UIColor * | secondaryTextColor |
| لون الصف الثاني من النص في نتائج الإكمال التلقائي. | |
| UIColor * | التلوين الخفيف |
| لون التلوين الخفيف المطبّق على عناصر التحكّم في عرض الإكمال التلقائي | |
| GMSPlaceField | placeFields |
GMSPlaceField لتحديد تفاصيل مكان صريح. | |
وثائق وظيفة العضو
| - (instancetype) init |
لإعداد مصدر بيانات.
| - (void) sourceTextHasChanged: | (سلسلة NS* فارغة) | text (النص) |
أبلغ مصدر البيانات بأن النص المصدر المراد إكماله تلقائيًا قد تم تغييره.
يجب استدعاء هذه الطريقة من سلسلة المحادثات الرئيسية فقط. سيؤدي استدعاء هذه الطريقة من سلسلة محادثات أخرى إلى حدوث سلوك غير محدَّد. سيتم أيضًا استدعاء المكالمات إلى طرق GMSAutocompleteTableDataSourceDelegate في سلسلة المحادثات الرئيسية.
لا تحظر هذه الطريقة.
- المعلّمات:
-
ملف نصي النص الجزئي المطلوب إكماله تلقائيًا.
| - (void) clearResults |
محو جميع التوقعات.
- ملاحظة:
- سيؤدي هذا إلى استدعاء طريقتي التفويض أدناه:
didUpdateAutocompletePredictionsForResultsController:didRequestAutocompletePredictionsForResultsController:
ويضمن تنفيذ هذه الطريقة استدعاء هذه الطريقة بشكل متزامن وفي الطلب.
وثائق الملكية
- (معرّف IBOutlet<GMScompletionTableDataDataDelegate>) تفويض [read, write, assign] |
تفويض ليتم إشعارك عند تحديد مكان أو إلغاء الاختيار.
- (GMScompletionFilter*) 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 لتحديد تفاصيل مكان صريح.
تعرض القيمة التلقائية جميع الحقول المتاحة.