مشاركة عبر

معالجة أحداث الخريطة

  • مقالة

توضح لك هذه المقالة كيفية استخدام فئة أحداث الخريطة. تسلط الخاصية الضوء على الأحداث على الخريطة وعلى طبقات مختلفة من الخريطة. يمكنك أيضًا تمييز الأحداث عند التفاعل مع علامة HTML.

التفاعل مع الخريطة

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

لقطة شاشة تعرض خريطة مع قائمة بأحداث الخريطة التي يتم تمييزها في أي وقت تقوم فيه الإجراءات الخاصة بك على مشغل الخريطة بتشغيل هذا الحدث.

التفاعل مع طبقات الخريطة

يسلط نموذج أحداث الطبقة الضوء على اسم الأحداث التي يتم إطلاقها أثناء التفاعل مع طبقة الرمز. تدعم طبقة الرمز والفقاعة والخط والمضلع جميعها نفس مجموعة الأحداث. لا تدعم خريطة التمثيل اللوني وطبقات التجانب أيًا من هذه الأحداث. للحصول على التعليمات البرمجية المصدر لهذا النموذج، راجع التعليمات البرمجية المصدر لأحداث الطبقة.

لقطة شاشة تعرض خريطة مع قائمة بأحداث الطبقة التي يتم تمييزها في أي وقت تتفاعل فيه مع طبقة الرمز.

التفاعل مع علامة HTML

يسلط نموذج أحداث طبقة علامة HTML الضوء على اسم الأحداث التي يتم إطلاقها أثناء التفاعل مع طبقة علامة HTML. للحصول على التعليمات البرمجية المصدر لهذا النموذج، راجع التعليمات البرمجية المصدر لطبقة علامة HTML Events.

لقطة شاشة تعرض خريطة مع قائمة بأحداث طبقة علامة HTML التي يتم تمييزها في أي وقت تقوم فيه الإجراءات الخاصة بك على مشغل الخريطة بتشغيل هذا الحدث.

يسرد الجدول التالي جميع أحداث فئة الخريطة المدعومة.

حدث ‏‏الوصف
boxzoomend يتم تشغيله عند انتهاء تفاعل "تكبير/تصغير مربع".
boxzoomstart يتم تشغيله عند بدء تفاعل "تكبير/تصغير مربع".
click يتم تشغيله عند الضغط على جهاز تأشير وإصداره في نفس النقطة على الخريطة.
close يتم تشغيله عند إغلاق النافذة المنبثقة يدويا أو برمجيا.
contextmenu يتم تشغيله عند النقر فوق الزر الأيمن للماوس.
data يتم تشغيله عند تحميل أي بيانات خريطة أو تغييرها.
dataadded يتم تشغيله عند إضافة الأشكال إلى DataSource.
dataremoved يتم تشغيله عند إزالة الأشكال من DataSource.
datasourceupdated يتم تشغيله عند تحديث الكائن DataSource.
dblclick يتم تشغيله عند النقر فوق جهاز تأشير مرتين في نفس النقطة على الخريطة.
drag تم تشغيله بشكل متكرر في أثناء تفاعل "السحب للتحريك" على الخريطة أو النافذة المنبثقة أو علامة HTML.
dragend يتم تشغيله عند انتهاء تفاعل "السحب للتحريك" على الخريطة أو النافذة المنبثقة أو علامة HTML.
dragstart يتم تشغيله عند بدء تفاعل "السحب للتحريك" على الخريطة أو النافذة المنبثقة أو علامة HTML.
error يتم تشغيله عند حدوث خطأ.
idle

تم تنشيطه بعد آخر إطار تم عرضه قبل أن تدخل الخريطة في حالة "idle":

  • لا توجد مراحل انتقالية جارية في الكاميرا.
  • تم تحميل جميع المربعات المطلوبة حالياً.
  • اكتملت جميع حركات التلاشي/الانتقال.
keydown يتم تشغيله عند الضغط على مفتاح لأسفل.
keypress يتم تشغيله عند الضغط على مفتاح ينتج حرفا قابلا للكتابة (مفتاح ANSI).
keyup يتم تشغيله عند إصدار مفتاح.
layeradded يتم تنشيطه عند إضافة طبقة إلى الخريطة.
layerremoved يتم تنشيطه عند إزالة طبقة من الخريطة.
load تم إطلاقه مباشرة بعد تنزيل جميع الموارد الضرورية وحدث أول عرض كامل بصريًا للخريطة.
mousedown يتم تشغيله عند الضغط على جهاز تأشير داخل الخريطة أو عندما يكون أعلى عنصر.
mouseenter يتم تشغيله عند نقل جهاز تأشير في البداية عبر الخريطة أو عنصر.
mouseleave يتم تشغيله عند نقل جهاز تأشير خارج الخريطة أو عنصر.
mousemove يتم تشغيله عند نقل جهاز تأشير داخل الخريطة أو عنصر.
mouseout يتم تشغيله عندما يترك جهاز نقطة لوحة الخريطة يترك عنصرًا.
mouseover يتم تشغيله عند نقل جهاز تأشير فوق الخريطة أو عنصر.
mouseup يتم تشغيله عند إصدار جهاز تأشير داخل الخريطة أو عندما يكون أعلى عنصر.
move تم تشغيله بشكل متكرر أثناء الانتقال المتحرك من طريقة عرض إلى أخرى، كنتيجة لتفاعل المستخدم أو الأساليب.
moveend يتم تشغيله بعد أن تكمل الخريطة الانتقال من طريقة عرض إلى أخرى، كنتيجة لتفاعل المستخدم أو الأساليب.
movestart تم تشغيله قبل أن تبدأ الخريطة في الانتقال من طريقة عرض إلى أخرى، كنتيجة لتفاعل المستخدم أو الأساليب.
open يتم تشغيله عند فتح النافذة المنبثقة يدويا أو برمجيا.
pitch يتم تشغيله كلما تغير عرض الخريطة (إمالة) كنتيجة لتفاعل المستخدم أو الأساليب.
pitchend يتم تشغيله مباشرة بعد انتهاء عرض الخريطة (إمالة) من التغيير نتيجة لتفاعل المستخدم أو الأساليب.
pitchstart يتم تشغيله عندما يبدأ عرض الخريطة (إمالة) التغيير نتيجة لتفاعل المستخدم أو الأساليب.
ready يتم تشغيله عند تحميل الحد الأدنى من موارد الخريطة المطلوبة قبل أن تكون الخريطة جاهزة للتفاعل معها برمجيًا.
render

يتم تشغيله كلما تم رسم الخريطة على الشاشة، كنتيجة لـ:

  • تغيير في موضع الخريطة أو التكبير/التصغير أو العرض التقديمي أو الحمل.
  • تغيير في نمط الخريطة.
  • تغيير إلى مصدر DataSource.
  • تحميل تجانب متجه أو ملف GeoJSON أو صورة جليقة أو sprite.
resize أطلق مباشرة بعد تغيير حجم الخريطة.
rotate تم تشغيله بشكل متكرر أثناء تفاعل "السحب لتدوير".
rotateend يتم تشغيله عند انتهاء تفاعل "السحب للتدوير".
rotatestart يتم تشغيله عند بدء تفاعل "السحب للتدوير".
shapechanged يتم تشغيله عند تغيير خاصية كائن شكل.
sourcedata يتم تشغيله عند تحميل أحد مصادر الخريطة أو تغييرها، بما في ذلك إذا تم تحميل لوحة تنتمي إلى مصدر أو تغييره.
sourceadded يتم تشغيله عند إضافة DataSource أو VectorTileSource إلى الخريطة.
sourceremoved يتم تنشيطه عند إزالة DataSource أو VectorTileSource من الخريطة.
styledata يتم تشغيله عند تحميل نمط الخريطة أو تغييره.
styleimagemissing يتم تشغيله عندما تحاول طبقة تحميل صورة من صورة غير موجودة
tokenacquired يتم تشغيله عند الحصول على رمز مميز للوصول إلى Microsoft Entra.
touchcancel يتم تشغيله عند وقوع حدث touchcancel داخل الخريطة.
touchend يتم تشغيله عند وقوع حدث touchend داخل الخريطة.
touchmove يتم تشغيله عند وقوع حدث touchmove داخل الخريطة.
touchstart يتم تشغيله عند وقوع حدث touchstart داخل الخريطة.
wheel يتم تشغيله عند حدوث حدث عجلة الماوس داخل الخريطة.
zoom تم تشغيله بشكل متكرر أثناء الانتقال المتحرك من مستوى تكبير/تصغير إلى آخر، نتيجة لتفاعل المستخدم أو الأساليب.
zoomend تم تشغيله بعد أن تكمل الخريطة الانتقال من مستوى تكبير/تصغير إلى آخر، كنتيجة لتفاعل المستخدم أو الأساليب.
zoomstart تم تشغيله قبل أن تبدأ الخريطة في الانتقال من مستوى تكبير/تصغير إلى آخر، كنتيجة لتفاعل المستخدم أو الأساليب.

الخطوات التالية

راجع المقالات التالية للحصول على أمثلة التعليمة البرمجية الكاملة:

استخدام الوحدة لخدمات Azure Maps

نماذج التعليمات البرمجية