الدالة Keyboard.press()‎ في أردوينو

ترسل الدالة 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()‎ في توثيق أردوينو الرسمي.