الفرق بين المراجعتين ل"Arduino/keyboard/keyboardprintln"

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

المراجعة الحالية بتاريخ 19:47، 6 نوفمبر 2018

يرسل التابع println()‎ ضغطة أو عدة ضغطات من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل ثمَّ يُتبِعها بمحرف سطر جديد ومحرف العودة إلى بداية السطر.

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

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

Keyboard.println()
Keyboard.println(character)
Keyboard.println(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.println("Hello!");
  }
}

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

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

انظر أيضًا

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

مصادر