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

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

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

==البنية العامة==
<syntaxhighlight lang="arduino">
Keyboard.println()
Keyboard.println(character)
Keyboard.println(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.println("Hello!");
  }
}
</syntaxhighlight>

== ملاحظات وتحذيرات ==
عند استعمال التابع <code>println()‎</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/keyboardprint|print()‎]]</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/keyboardprintln/ صفحة التابع Keyboard.println()‎ في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Method]]
[[تصنيف: Arduino USB]]
[[تصنيف: Arduino Keyboard]]