סקירה כללית
GMSAutocompleteTableDataSource היא ממשק שמספק חיזויים של השלמה אוטומטית של מקומות כדי לאכלס UITableView על-ידי הטמעת הפרוטוקולים UITableViewDataSource ו-UITableView בוצע הקצאה.
הפרמטר GMSAutocompleteTableDataSource מיועד לשמש כמקור הנתונים של UISearchDisplayController.
- הערה:
- ממשק המשתמש UISearchDisplayController הוצא משימוש החל מ-iOS 8. עכשיו מומלץ להשתמש ב-UISearchController עם
GMSAutocompleteResultsViewControllerכדי להציג תוצאות של השלמה אוטומטית באמצעות ממשק המשתמש של החיפוש ב-iOS.
מגדירים מופע של GMSAutocompleteTableDataSource בתור המאפיינים searchResultsDataSource ו-searchResults ימין של ממשק UISearchDisplayController. ביישום של needReloadTableForSearchString, קוראים ל-sourceTextHasChanged עם מחרוזת החיפוש הנוכחית.
אפשר להשתמש בפרוטוקול ההאצלה של GMSAutocompleteTableDataSourceDelegate כדי לקבל הודעה כשמקום מסוים נבחר מהרשימה. מאחר שחיזויים של השלמה אוטומטית נטענים באופן אסינכרוני, יש להטמיע את didUpdateUpdatedictions ואת קריאה מחדש של הנתונים בתצוגת הטבלה של UISearchDisplayController.
פונקציות של חברי מועדון | |
| (instancetype) | - init |
| ההפעלה של מקור נתונים מתבצעת. | |
| (void) | - sourceTextHasChanged: |
| להודיע למקור הנתונים שחל שינוי בטקסט המקור להשלמה האוטומטית. | |
| (void) | – clearResults |
| ניקוי כל החיזויים. | |
נכסים | |
| מזהה IBOutlet < GMSAutocompleteTableDataSourceDelegate > | להאציל |
| הענקת גישה לקבלת הודעה כאשר מקום נבחר או שהבחירה מבוטלת. | |
| GMSAutocompleteFilter * | autocompleteFilter |
| פילטר של החלה על הצעות להשלמה אוטומטית (מספר אפסים). | |
| UIColor * | tableCellBackgroundColor |
| צבע הרקע של תאי טבלה. | |
| UIColor * | tableCellSeparatorColor |
| צבע הקו המפריד בין תאים בטבלה. | |
| UIColor * | primaryTextColor |
| הצבע של טקסט שם התוצאה בתוצאות של השלמה אוטומטית. | |
| UIColor * | primaryTextHighlightColor |
| הצבע שמשמש להדגשת טקסט תואם בתוצאות של השלמה אוטומטית. | |
| UIColor * | secondaryTextColor |
| הצבע של שורת הטקסט השנייה בתוצאות של ההשלמה האוטומטית. | |
| UIColor * | tintColor |
| צבע הגוון שהוחל על פקדים בתצוגה 'השלמה אוטומטית'. | |
| GMSPlaceField | placeFields |
GMSPlaceField לציון פרטים מפורשים של מקום שיש לבקש. | |
| NSArray< GMSPlaceProperty > * | placeProperties |
GMSPlaceProperty לציון פרטים מפורשים של מקום שיש לבקש. | |
מסמכי תיעוד לגבי פונקציות של חברים
| - (instancetype) init |
ההפעלה של מקור נתונים מתבצעת.
| - (בטל) sourceTextHasChanged: | (nullable NSString *) | טקסט |
להודיע למקור הנתונים שחל שינוי בטקסט המקור להשלמה האוטומטית.
יש לקרוא לשיטה הזו רק מה-thread הראשי. קריאה לשיטה הזו משרשור אחר תגרום להתנהגות לא מוגדרת. קריאות לשיטות של GMSAutocompleteTableDataSourceDelegate ייקראו גם ב-thread הראשי.
שיטה זו לא חוסמת.
- פרמטרים:
-
טקסט הטקסט החלקי שיושלם אוטומטית.
| - (ביטול) 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 לציון פרטים מפורשים של מקום שיש לבקש.
ברירת המחדל מחזירה את כל השדות הזמינים.
- (NSArray<GMSPlaceProperty>*) placeProperties [read, write, assign] |
GMSPlaceProperty לציון פרטים מפורשים של מקום שיש לבקש.
ברירת המחדל מחזירה את כל המאפיינים הזמינים.