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

<noinclude>{{DISPLAYTITLE:الدالة <code>Keyboard.print()‎</code> في أردوينو}}</noinclude>
ترسل الدالة <code>print()‎</code> ضغطة أو عدة ضغطات من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل.

يجب استدعاء الدالة <code>print()‎</code> بعد بدء لوحة المفاتيح عبر استدعاء الدالة <code>[[Arduino/keyboard/keyboardbegin|begin()‎]]</code>.

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

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

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

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

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

== أمثلة ==
إرسال رسالة إلى الحاسوب بالضغط على عدة مفاتيح عند الضغط على الزر المتصل بالرجل 2:<syntaxhighlight lang="arduino">
#include <Keyboard.h>

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

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

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

==انظر أيضًا==
* الدالة <code>[[Arduino/keyboard/keyboardbegin|begin()‎]]</code>: تبدأ عملية محاكاة (emulating) للوحة مفاتيح افتراضية موصولة بالحاسوب المتصل باللوحة Leonardo أو Due.
* الدالة <code>[[Arduino/keyboard/keyboardend|end()‎]]</code>: توقف عملية محاكاة (emulating) وصل لوحة المفاتيح الافتراضية بالحاسوب المتصل باللوحة.
* الدالة <code>[[Arduino/keyboard/keyboardpress|press()‎]]</code>: تسلك عند استدعائها نفس سلوك عملية الضغط على زرٍ في لوحة المفاتيح باستمرار.
* الدالة <code>[[Arduino/keyboard/keyboardprintln|println()‎]]</code>: ترسل ضغطة أو عدة ضغطات من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل ثمَّ تُتبِعها بمحرف سطر جديد ومحرف العودة إلى بداية السطر.
* الدالة <code>[[Arduino/keyboard/keyboardrelease|release()‎]]</code>: تحرِّر مفتاحًا محدَّدًا ضُغِط عليه مسبقًا باستعمال الدالة <code>[[Arduino/keyboard/keyboardpress|press()‎]]</code>.
* الدالة <code>[[Arduino/keyboard/keyboardreleaseall|releaseAll()‎]]</code>: تحرِّر جميع المفاتيح التي ضُغِط عليها مسبقًا باستعمال الدالة <code>[[Arduino/keyboard/keyboardpress|press()‎]]</code>.
* الدالة <code>[[Arduino/keyboard/keyboardwrite|write()‎]]</code>: ترسل ضغطة زر واحدة من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل.

==مصادر==
*[https://www.arduino.cc/reference/en/language/functions/usb/keyboard/keyboardprint/ صفحة Keyboard.print()‎ في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Function]]
[[تصنيف: Arduino USB]]
[[تصنيف: Arduino Keyboard]]