رموز مؤشّر الماوس

يصل مستخدمو Android إلى تطبيقك عبر مجموعة متنوعة من الأجهزة، مثل الهواتف والأجهزة اللوحية والهواتف القابلة للطي وأجهزة Chromebook. وعندما يتفاعلون مع تطبيقك، خاصةً على الشاشات الكبيرة، قد يستخدمون أيضًا نوعًا من أجهزة التأشير، مثل الماوس بثلاثة أزرار. تتيح تطبيقات Android إمكانية تطبيق أنماط مختلفة على مؤشر الماوس، وذلك لتقديم إشارة مرئية للمستخدمين توضّح إمكانية التفاعل مع عنصر معيّن.

استخدام المؤشرات التلقائية للنظام

لدى المستخدمين خبرة في الطرق المتنوعة للتفاعل مع عناصر مختلفة على الأجهزة ذات الشاشات الكبيرة. بناء على ذلك، يوفّر نظام التشغيل Android للمطوّرين بعضًا من رموز المؤشر الأكثر شيوعًا التي يعرفها المستخدمون. يمكنك إضافة رموز المؤشر التلقائية هذه باستخدام بضعة أسطر من الرموز. لِنلقِ نظرة على مقتطف Kotlin التالي: 

myView.setOnHoverListener { view, _ ->
      view.pointerIcon =
         PointerIcon.getSystemIcon(applicationContext, PointerIcon.TYPE_HAND)
      false // Listener did not consume the event.
}

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

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

تتضمّن Android العديد من رموز النظام، ويمكنك الاطّلاع على القائمة الكاملة في أسفل هذه الصفحة. تم استخدام الرمز TYPE_HAND الذي يعرض يدًا مغلقة مع تمديد إصبع السبابة.

استخدام مؤشر خاص بك

// Loading a bitmap to use as a pointer icon
    BitmapFactory.decodeResource(
        this.resources,
        R.drawable.dollar_sign
    ), CURSOR_WIDTH, CURSOR_HEIGHT, false
)

// Creating the pointer icon and sending clicks from the center of the mouse icon
PointerIcon.create(dollarBitmap, (CURSOR_WIDTH/2).toFloat(), (CURSOR_HEIGHT/2).toFloat())

ملاحظة: يعتمد موقع النقطة الفعّالة على حالة الاستخدام. على سبيل المثال، سيضبط تطبيق الرسم نقطة الاتصال لتكون طرف القلم أو فرشاة الرسم.

أمثلة

تُعد إضافة رموز المؤشر إلى تطبيقك طريقة رائعة لمساعدة مستخدمي Android على الاستفادة من تجارب أكثر سلاسة على جميع أشكال الأجهزة التي يستخدمونها. تتوفّر الكثير من رموز النظام التلقائية الرائعة، وإذا لم تناسب احتياجاتك، يمكنك دائمًا تحميل رموزك الخاصة أو إنشاؤها.

  • السحب والإفلات: إذا كان تطبيقك يتيح السحب من تطبيق آخر والإفلات في تطبيقك، يمكنك تنفيذ الرمز TYPE_NO_DROP. سيؤدي ذلك إلى عرض إشارة مرئية يفيد بأنّ تطبيقك لا يتوافق مع نوع MIME الذي تتم محاولة إفلاته في تطبيقك.
  • الخرائط: إذا كان لديك تطبيق خرائط وتريد إبلاغ المستخدمين بإمكانية تحريك الخريطة، يمكنك عرض الرمز TYPE_GRAB عند تمرير المؤشر فوقها. عندما ينقر المستخدم، يمكنك تغيير الرمز إلى يد ممسكة لإظهار أنّه يحرّك الخريطة.
  • تعديل الصور: يفضّل المستخدمون عناصر تحكّم تتيح لهم استخدام عدسة مكبّرة لتكبير الصورة. يمكنك تغيير المؤشر إلى عدسة مكبّرة باستخدام الرمز TYPE_ZOOM_IN عند اختيار وضع التكبير.
  • والعديد من الخيارات الأخرى

ملاحظة: للاطّلاع على تغييرات مختلفة في المؤشر أثناء التنفيذ، يمكنك الاطّلاع على GitHub Pointer Sample.

Android رموز مؤشر مخصّصة في تطبيق‎

الملحق

موادّ إضافية للقراءة

المؤشرات التلقائية للنظام

في ما يلي المؤشرات المتاحة تلقائيًا في نظام التشغيل Android.

اسم المؤشر رمز
TYPE_ALIAS مؤشر الاسم المستعار، وهو سهم بجانبه سهم صغير منحني
TYPE_ALL_SCROLL مؤشر التمرير في كل الاتجاهات، وهو عبارة عن دائرة تحتوي على أربعة أسهم تشير إلى الخارج
TYPE_ARROW مؤشر السهم العادي
TYPE_CELL مؤشر الخلية
TYPE_CONTEXT_MENU مؤشر قائمة السياق، وهو سهم بجانبه رمز قائمة صغير
TYPE_COPY مؤشر النسخ، وهو سهم بجانبه علامة جمع
TYPE_CROSSHAIR مؤشر التصويب، وهو علامة زائد تتضمّن نقطة في المنتصف
TYPE_DEFAULT مؤشر السهم التلقائي
TYPE_GRAB مؤشر السحب، وهو عبارة عن يد مفتوحة
TYPE_GRABBING مؤشر الإمساك، وهو عبارة عن يد مغلقة
TYPE_HAND مؤشر اليد، وهو عبارة عن يد تشير بإصبع السبابة
TYPE_HELP مؤشر المساعدة، وهو سهم بجانبه علامة استفهام
TYPE_HORIZONTAL_DOUBLE_ARROW مؤشر السهم المزدوج الأفقي لتغيير الحجم
TYPE_NO_DROP مؤشر عدم الإفلات، وهو عبارة عن دائرة يتوسطها خط
TYPE_NULL لن يتم عرض أي مؤشر
TYPE_TEXT .مؤشر النص، وهو عبارة عن خط عمودي
TYPE_TOP_LEFT_DIAGONAL_DOUBLE_ARROW مؤشر السهم المزدوج القطري من أعلى اليسار إلى أسفل اليمين لتغيير الحجم
TYPE_TOP_RIGHT_DIAGONAL_DOUBLE_ARROW مؤشر السهم المزدوج القطري من أعلى اليسار إلى أسفل اليمين لتغيير الحجم
TYPE_VERTICAL_DOUBLE_ARROW مؤشر السهم المزدوج العمودي لتغيير الحجم
TYPE_VERTICAL_TEXT I‎ مؤشر النص العمودي، وهو عبارة عن خط أفقي على شكل حرف
TYPE_WAIT مؤشر الانتظار، وهو عبارة عن ساعة رملية أو دائرة دوّارة
TYPE_ZOOM_IN مؤشر التكبير، وهو عبارة عن عدسة مكبّرة مع علامة زائد
TYPE_ZOOM_OUT مؤشر التصغير، وهو عبارة عن عدسة مكبّرة مع علامة طرح