عرض مصدر Arduino/keyboard/keyboardpress

<noinclude>{{DISPLAYTITLE:التابع <code>Keyboard.press()‎</code> في أردوينو}}</noinclude>
يسلك التابع <code>press()‎</code> عند استدعائه نفس سلوك عملية الضغط على زرٍ في لوحة المفاتيح باستمرار. هذه التابع مفيدة لاستعمالها مع [[Arduino/keyboard/keyboardmodifiers|مفاتيح التبديل]]. لإنهاء عملية الضغط على الزر وتحريره، استعمل التابع <code>[[Arduino/keyboard/keyboardrelease|release()‎]]</code> أو التابع <code>releaseAll()‎</code>.

يجب استدعاء التابع <code>[[Arduino/keyboard/keyboardbegin|begin()‎]]</code> قبل استدعاء التابع <code>press()‎</code>.

==البنية العامة==
<syntaxhighlight lang="arduino">
Keyboard.press(char)
</syntaxhighlight>

== المعاملات ==

=== <code>char</code> ===
المفتاح المراد ضغطه باستمرار.

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

== أمثلة ==
استعمال لوحة المفاتيح الافتراضية لإنشاء مستند جديد في الحاسوب:<syntaxhighlight lang="arduino">
#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);
}
</syntaxhighlight>
==انظر أيضًا==
*التابع <code>[[Arduino/keyboard/keyboardbegin|begin()‎]]</code>: يبدأ عملية محاكاة (emulating) للوحة مفاتيح افتراضية موصولة بالحاسوب المتصل باللوحة Leonardo أو Due.
*التابع <code>[[Arduino/keyboard/keyboardend|end()‎]]</code>: يوقف عملية محاكاة (emulating) وصل لوحة المفاتيح الافتراضية بالحاسوب المتصل باللوحة.
*التابع <code>[[Arduino/keyboard/keyboardprint|print()‎]]</code>: يرسل ضغطة أو عدة ضغطات من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل.
*التابع <code>[[Arduino/keyboard/keyboardprintln|println()‎]]</code>: يرسل ضغطة أو عدة ضغطات من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل ثمَّ يُتبِعها بمحرف سطر جديد ومحرف العودة إلى بداية السطر.
*التابع <code>[[Arduino/keyboard/keyboardrelease|release()‎]]</code>: يحرِّر مفتاحًا محدَّدًا ضُغِط عليه مسبقًا باستعمال التابع <code>press()‎</code>.
*التابع <code>[[Arduino/keyboard/keyboardreleaseall|releaseAll()‎]]</code>: يحرِّر جميع المفاتيح التي ضُغِط عليها مسبقًا باستعمال التابع <code>press()‎</code>.
*التابع <code>[[Arduino/keyboard/keyboardwrite|write()‎]]</code>: يرسل ضغطة زر واحدة من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل.
==مصادر==
*[https://www.arduino.cc/reference/en/language/functions/usb/keyboard/keyboardpress/ صفحة التابع Keyboard.press()‎ في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Method]]
[[تصنيف: Arduino USB]]
[[تصنيف: Arduino Keyboard]]