Arduino/keyboard/keyboardpress

يسلك التابع press()‎ عند استدعائه نفس سلوك عملية الضغط على زرٍ في لوحة المفاتيح باستمرار. هذه التابع مفيدة لاستعمالها مع مفاتيح التبديل. لإنهاء عملية الضغط على الزر وتحريره، استعمل التابع release()‎ أو التابع releaseAll()‎.

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

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

Keyboard.press(char)

المعاملات

char

المفتاح المراد ضغطه باستمرار.

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

يعاد الرقم المرسل لضغطة المفتاح.

أمثلة

استعمال لوحة المفاتيح الافتراضية لإنشاء مستند جديد في الحاسوب:

#include <Keyboard.h>

// OS X استعمل هذا الخيار من أجل أنظمة
char ctrlKey = KEY_LEFT_GUI;
// أو استعمال هذا الخيار من أجل أنظمة ويندوز ولينكس
//  char ctrlKey = KEY_LEFT_CTRL;

void setup() {
  // جعل الرجل 2 رجل دخل مع تشغيل مقاومة الرفع
  // الداخلية، لذا سيصبح جهد الرجل 2 مرتفعًا إلا
  // إذا وصلت بالخط الأرضي
  pinMode(2, INPUT_PULLUP);
  // تهيئة لوحة المفاتيح للتحكم بها
  Keyboard.begin();
}

void loop() {
  while (digitalRead(2) == HIGH) {
    // لا تغفل شيئًا حتى يُضغَط على الزر المتصل بالرجل 2
    delay(500);
  }
  delay(1000);
  // إنشاء مستند جديد
  Keyboard.press(ctrlKey);
  Keyboard.press('n');
  delay(100);
  Keyboard.releaseAll();
  // انتظار فتح نافذة جديدة
  delay(1000);
}

انظر أيضًا

• التابع begin()‎: يبدأ عملية محاكاة (emulating) للوحة مفاتيح افتراضية موصولة بالحاسوب المتصل باللوحة Leonardo أو Due.
• التابع end()‎: يوقف عملية محاكاة (emulating) وصل لوحة المفاتيح الافتراضية بالحاسوب المتصل باللوحة.
• التابع print()‎: يرسل ضغطة أو عدة ضغطات من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل.
• التابع println()‎: يرسل ضغطة أو عدة ضغطات من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل ثمَّ يُتبِعها بمحرف سطر جديد ومحرف العودة إلى بداية السطر.
• التابع release()‎: يحرِّر مفتاحًا محدَّدًا ضُغِط عليه مسبقًا باستعمال التابع press()‎.
• التابع releaseAll()‎: يحرِّر جميع المفاتيح التي ضُغِط عليها مسبقًا باستعمال التابع press()‎.
• التابع write()‎: يرسل ضغطة زر واحدة من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل.

مصادر

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