Arduino/mouse/mouserelease

تحرِّر الدالة release()‎ زر الفأرة الذي ضُغِط عليه مسبقًا باستعمال الدالة press()‎.

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

Mouse.release();
Mouse.release(button);

المعاملات

button

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

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

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

يعاد عدد المفاتيح المُحرَّرة.

أمثلة

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

#include <Mouse.h>

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

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

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

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

انظر أيضًا

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

مصادر

• صفحة Keyboard.release()‎ في توثيق أردوينو الرسمي.