סקירה כללית
GMSOverlay הוא מחלקה מופשטת שמייצגת שכבת-על מסוימת שעשויה להיות מצורף אל GMSMapView ספציפי.
הוא לא יכול ליצור אובייקט (instantiation) באופן ישיר. במקום זאת, צריך ליצור באופן ישיר מופעים של סוגי שכבת-על בטון (למשל GMSMarker, GMSPolyline ו-GMSPolygon).
האפשרות הזו תומכת בפרוטוקול NSCopy . [overlay_ copy] יחזיר עותק של סוג שכבת-העל, אבל הערך של map
הוא אפס.
ההגדרה עוברת בירושה על ידי GMSCircle, GMSGroundOverlay, GMSMarker, GMSPolygon ו-GMSPolyline.
נכסים | |
NSString * | שם הפריט |
כותרת, תיאור קצר של שכבת-העל. | |
GMSMapView * | מפה |
המפה שבה מוצגת שכבת-העל. | |
בול (BOOL) | tappable |
אם שכבת-העל הזו אמורה לגרום להתראות על הקשה. | |
int | zIndex |
שכבות-על של ערך zIndex גבוה יותר ישורטטו מעל לשכבות-על ושכבות-על של משבצות של ערכי zIndex . | |
id [מזהה] | userData |
נתוני שכבות-על. |
מסמכי תיעוד לגבי הנכס
- (NSString*) title [read, write, copy] |
כותרת, תיאור קצר של שכבת-העל.
שכבות-על מסוימות, כגון סמנים, יציגו את הכותרת במפה. הכותרת היא גם טקסט ברירת המחדל לנגישות.
- (GMSMapView*) מפה [read, write, assign] |
המפה שבה מוצגת שכבת-העל.
הגדרת המאפיין הזה תוסיף את שכבת-העל למפה. הגדרת הערך אפס תגרום להסרת שכבת-העל הזו מהמפה. שכבת-על יכולה להיות פעילה במפה אחת לכל היותר בכל זמן נתון.
- (BOOL) ניתן להקיש [read, write, assign] |
אם שכבת-העל הזו אמורה לגרום להתראות על הקשה.
שכבות-על מסוימות, כמו סמנים, יוגדרו כברירת מחדל כניתנות להקשה.
- (int) zIndex [read, write, assign] |
שכבות-על של ערך zIndex
גבוה יותר ישורטטו מעל לשכבות-על ושכבות-על של משבצות של ערכי zIndex
.
ערכים שווים מובילים לסדר שרטוט לא מוגדר. סמנים הם יוצאי דופן לכך שבלי קשר ל-zIndex
, הם תמיד יצוירו מעל שכבות אריחים ושכבות-על אחרות שאינן סמנים; למעשה הם נחשבים בפועל לקבוצה נפרדת של אינדקס z בהשוואה לשכבות-על אחרות.
- (id) userData [read, write, assign] |
נתוני שכבות-על.
ניתן להשתמש במאפיין הזה כדי לשייך אובייקט שרירותי לשכבת-העל הזו. ה-SDK של מפות Google ל-iOS לא קורא או כותב את הנכס הזה.
הערה: אסור שיהיו ב-userData הפניות חזקות לאובייקטים של מפות Google, אחרת יכול להיווצר מחזור שמירה (מונע שחרור של אובייקטים).