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