הפניה כיתתית לשכבת-על של GMS

הפניה למחלקה של GMSOverlay

סקירה כללית

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, אחרת יכול להיווצר מחזור שמירה (מונע שחרור של אובייקטים).