الدالة Keyboard.println() في أردوينو
ترسل الدالة 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(): ترسل ضغطة زر واحدة من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل.