Arduino/keyboard/keyboardprint

يرسل التابع print()‎ ضغطة أو عدة ضغطات من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل.

يجب استدعاء التابع print()‎ بعد بدء لوحة المفاتيح عبر استدعاء التابع begin()‎.

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

Keyboard.print(character)
Keyboard.print(characters)

المعاملات

character

محرفٌ أو رقم يراد إرساله إلى الحاسوب على أنَّه ناتج عن ضغطة زر في لوحة المفاتيح.

characters

سلسلة نصية يراد إرسالها إلى الحاسوب على أنَّها ناتجة عن عدة ضغطات متسلسلة على لوحة المفاتيح.

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

يعاد عدد البايتات المرسلة.

أمثلة

إرسال رسالة إلى الحاسوب بالضغط على عدة مفاتيح عند الضغط على الزر المتصل بالرجل 2:

#include <Keyboard.h>

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

void loop() {
  // إن ضُغِط على الزر المتصل بالرجل 2
  if(digitalRead(2)==LOW){
    // أرسل الرسالة
    Keyboard.print("Hello!");
  }
}

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

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

انظر أيضًا

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

مصادر

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