Arduino/mouse/mousepress

يرسل التابع press()‎ ضغطة مستمرة إلى الحاسوب عند موقع مؤشر الفأرة الحالي. يشبه سلوك هذه التابع الضغط باستمرار على زر الفأرة. يُحرَّر زر الفأرة المضغوط عليه عبر استدعاء التابع release()‎.

قبل استعمال التابع press()‎، يجب استدعاء التابع begin()‎.

البنية العامة

Mouse.press();
Mouse.press(button)

المعاملات

button

محرفٌ يحدِّد هذا المعامل زر الفأرة المراد ضغطه باستمرار. القيم التي يمكن استعمالها مع هذا المعامل هي:

• MOUSE_LEFT (القيمة الافتراضية)
• MOUSE_RIGHT
• MOUSE_MIDDLE

القيم المعادة

لا يعاد أي شيء.

أمثلة

استعمال قاطعتين لضغط زر الفأرة الأيسر باستمرار وتحريره في موقع المؤشر الحالي:

#include <Mouse.h>

void setup(){
  // قاطعة تستعمل من أجل الضغط على زر الفأرة
  pinMode(2,INPUT);
  // قاطعة أخرى تستعمل من أجل تحرير الزر المضغوط
  pinMode(3,INPUT);
  // Mouse تهيئة وبدء المكتبة
  Mouse.begin();
}

void loop(){
  // إن أغلقت القاطعة المتصلة بالرجل 2، اضغط زر الفأرة الأيسر باستمرار
  if(digitalRead(2) == HIGH){
    Mouse.press();
  }
  // إن أغلقت القاطعة المرتبطة المتصلة بالرجل 3، حرر زر الفأرة الأيسر المضغوط
  if(digitalRead(3) == HIGH){
    Mouse.release();
  }
}

ملاحظات وتحذيرات

عند استعمال التابع press()‎، تستحوذ أردوينو على الفأرة الحقيقية المتصلة بالحاسوب آنذاك، لذا تأكد من تحكمك بكل شيء قبل استدعاء هذه التابع. استعملنا في المثال السابق قاطعة لنتمكن عبر فتحها وإغلاقها من التحكم بعملية التبديل بين الفأرتين (الافتراضية والفعلية).

انظر أيضًا

• التابع begin()‎: يبدأ عملية محاكاة (emulating) لفأرة افتراضية موصولة بالحاسوب المتصل.
• التابع click()‎: يرسل ضغطة سريعة وخاطفة إلى الحاسوب عند موقع مؤشر الفأرة الحالي.
• التابع end()‎: يوقف عملية محاكاة (emulating) وصل فأرة افتراضية بالحاسوب المتصل. 
• التابع move()‎: يحرك مؤشر الفأرة في الحاسوب المتصل.
• التابع release()‎: يحرِّر زر الفأرة الذي ضُغِط عليه مسبقًا باستعمال التابع press()‎.
• التابع isPressed()‎: يتحقَّق إن كان زر معيَّن من أزرار الفأرة مضغوطًا أم لا.

مصادر

• صفحة التابع Mouse.press()‎ في توثيق أردوينو الرسمي.