الفرق بين المراجعتين لصفحة: «Arduino/keyboard»
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (5 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <noinclude>{{DISPLAYTITLE:المكتبة Keyboard في أردوينو}}</noinclude> | ||
تتيح | تتيح توابع المكتبة Keyboard إمكانية إرسال اللوحات التي تعتمد على متحكمات 32u4 أو SAMD ضغطات مفاتيحٍ من لوحة مفاتيح افتراضية إلى الحاسوب المتصل عبر المنفذ USB الأصلي للمتحكم. | ||
'''ملاحظة''': لا يمكن إرسال جميع المحارف ASCII المتاحة، خصوصًا تلك التي لا يمكن طباعتها (non-printing)، باستعمال المكتبة Keyboard. | '''ملاحظة''': لا يمكن إرسال جميع المحارف [[Arduino/asciichart|ASCII]] المتاحة، خصوصًا تلك التي لا يمكن طباعتها (non-printing)، باستعمال المكتبة Keyboard. | ||
__TOC__ | |||
تدعم المكتبة إمكانية استعمال [[Arduino/keyboard/keyboardmodifiers|مفاتيح التبديل]] التي تغيِّر سلوك مفتاح آخر عند الضغك عليها باستمرار (مثل المفتاح shift). انتقل إلى توثيق "[[Arduino/keyboard/keyboardmodifiers|مفاتيح التبديل]]" لمعلومات أوسع عن المفاتيح المدعومة واستعمالاتها. | تدعم المكتبة إمكانية استعمال [[Arduino/keyboard/keyboardmodifiers|مفاتيح التبديل]] التي تغيِّر سلوك مفتاح آخر عند الضغك عليها باستمرار (مثل المفتاح shift). انتقل إلى توثيق "[[Arduino/keyboard/keyboardmodifiers|مفاتيح التبديل]]" لمعلومات أوسع عن المفاتيح المدعومة واستعمالاتها. | ||
| سطر 8: | سطر 10: | ||
تسمح المكتبات الأساسية للوحات التي ترتكز على متحكمات 32u4 و SAMD (مثل عائلة Leonardo، و Esplora، و Zero، و Due، و MKR) بجعل الفأرة و/أو لوحة المفاتيح تبدوان عند وصلهما بالحاسوب وكأنَّهما أصليتان. | تسمح المكتبات الأساسية للوحات التي ترتكز على متحكمات 32u4 و SAMD (مثل عائلة Leonardo، و Esplora، و Zero، و Due، و MKR) بجعل الفأرة و/أو لوحة المفاتيح تبدوان عند وصلهما بالحاسوب وكأنَّهما أصليتان. | ||
هنالك '''تحذير''' واحد عند استعمال مكتبات [[Arduino/mouse|الفأرة]] ولوحة المفاتيح هو أنَّه إذا كانت المكتبة تعمل بشكل متواصل، فسيكون من الصعب حينذاك برمجة لوحتك. يجب أن تُستدعَى | هنالك '''تحذير''' واحد عند استعمال مكتبات [[Arduino/mouse|الفأرة]] ولوحة المفاتيح هو أنَّه إذا كانت المكتبة تعمل بشكل متواصل، فسيكون من الصعب حينذاك برمجة لوحتك. يجب أن تُستدعَى توابعٌ مثل <code>[[Arduino/mouse/mousemove|Mouse.move()]]</code> و <code>[[Arduino/keyboard/keyboardprint|Keyboard.print()]]</code> التي تحرك مؤشر الفأرة أو ترسل ضغات مفاتيحٍ إلى الحاسوب المتصل عندما تكون مستعدًا معالجتها والتعامل معها فقط. يُنصَح باستعمال نظام تحكم (control system) لتشغيل هذه الوظائف مثل استعمال قاطعة أو زر أو الاستجابة إلى مدخلات محدَّدة يمكنك التحكم بها فقط. يوجد في الأسفل عدة أمثلة عن الفأرة ولوحة المفاتيح للتعرف على بعض طرائق التعامل معهما. | ||
عند استعمال مكتبة الفأرة ولوحة المفاتيح، يُفضَل فحص المخرجات أولًا باستعمال | عند استعمال مكتبة الفأرة ولوحة المفاتيح، يُفضَل فحص المخرجات أولًا باستعمال التابع <code>[[Arduino/serial/print|()Serial.print]]</code>. تستطيع بهذه الطريقة التحقق والتأكد من القيم الناتجة. | ||
==<code>[[Arduino/keyboard/keyboardbegin| | ==<code>[[Arduino/keyboard/keyboardbegin|begin()]]</code>== | ||
يبدأ التابع عملية محاكاة (emulating) للوحة مفاتيح افتراضية موصولة بالحاسوب المتصل باللوحة Leonardo أو Due. | |||
==<code>[[Arduino/keyboard/keyboardend| | ==<code>[[Arduino/keyboard/keyboardend|end()]]</code>== | ||
يوقف التابع عملية محاكاة (emulating) وصل لوحة المفاتيح الافتراضية بالحاسوب المتصل باللوحة. | |||
==<code>[[Arduino/keyboard/keyboardpress| | ==<code>[[Arduino/keyboard/keyboardpress|press()]]</code>== | ||
يسلك التابع عند استدعائها نفس سلوك عملية الضغط على زرٍ في لوحة المفاتيح باستمرار. | |||
==<code>[[Arduino/keyboard/keyboardprint| | ==<code>[[Arduino/keyboard/keyboardprint|print()]]</code>== | ||
يرسل التابع ضغطة أو عدة ضغطات من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل. | |||
==<code>[[Arduino/keyboard/keyboardprintln| | ==<code>[[Arduino/keyboard/keyboardprintln|println()]]</code>== | ||
يرسل التابع ضغطة أو عدة ضغطات من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل ثمَّ يُتبِعها بمحرف سطر جديد ومحرف العودة إلى بداية السطر. | |||
==<code>[[Arduino/keyboard/keyboardrelease| | ==<code>[[Arduino/keyboard/keyboardrelease|release()]]</code>== | ||
يحرِّر التابع مفتاحًا محدَّدًا ضُغِط عليه مسبقًا باستعمال التابع <code>[[Arduino/keyboard/keyboardpress|press()]]</code>. | |||
==<code>[[Arduino/keyboard/keyboardreleaseall| | ==<code>[[Arduino/keyboard/keyboardreleaseall|releaseAll()]]</code>== | ||
يحرِّر التابع جميع المفاتيح التي ضُغِط عليها مسبقًا باستعمال التابع <code>[[Arduino/keyboard/keyboardpress|press()]]</code>. | |||
==<code>[[Arduino/keyboard/keyboardwrite| | ==<code>[[Arduino/keyboard/keyboardwrite|write()]]</code>== | ||
يرسل التابع ضغطة زر واحدة من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل. | |||
== انظر أيضًا == | == انظر أيضًا == | ||
* المكتبة [[Arduino/mouse|Mouse]]. | |||
* مثال: التحكم بلوحة المفاتيح والفأرة في برنامج واحد. | |||
* مثال: إرسال رسالة عبر لوحة المفاتيح. | |||
* مثال: تسجيل خروج المستخدم الحالي باستعمال لوحة المفاتيح. | |||
* مثال: استعمال لوحة المفاتيح مع واجهة الاتصال التسلسلية. | |||
* مثال: استعمال لوحة المفاتيح في إعادة برمجة لوحة أردوينو. | |||
[[تصنيف: Arduino]] | [[تصنيف: Arduino]] | ||
[[تصنيف: Arduino | [[تصنيف: Arduino Library]] | ||
[[تصنيف: Arduino USB]] | [[تصنيف: Arduino USB]] | ||
[[تصنيف: Arduino Keyboard]] | [[تصنيف: Arduino Keyboard]] | ||
المراجعة الحالية بتاريخ 19:59، 6 نوفمبر 2018
تتيح توابع المكتبة Keyboard إمكانية إرسال اللوحات التي تعتمد على متحكمات 32u4 أو SAMD ضغطات مفاتيحٍ من لوحة مفاتيح افتراضية إلى الحاسوب المتصل عبر المنفذ USB الأصلي للمتحكم.
ملاحظة: لا يمكن إرسال جميع المحارف ASCII المتاحة، خصوصًا تلك التي لا يمكن طباعتها (non-printing)، باستعمال المكتبة Keyboard.
تدعم المكتبة إمكانية استعمال مفاتيح التبديل التي تغيِّر سلوك مفتاح آخر عند الضغك عليها باستمرار (مثل المفتاح shift). انتقل إلى توثيق "مفاتيح التبديل" لمعلومات أوسع عن المفاتيح المدعومة واستعمالاتها.
تسمح المكتبات الأساسية للوحات التي ترتكز على متحكمات 32u4 و SAMD (مثل عائلة Leonardo، و Esplora، و Zero، و Due، و MKR) بجعل الفأرة و/أو لوحة المفاتيح تبدوان عند وصلهما بالحاسوب وكأنَّهما أصليتان.
هنالك تحذير واحد عند استعمال مكتبات الفأرة ولوحة المفاتيح هو أنَّه إذا كانت المكتبة تعمل بشكل متواصل، فسيكون من الصعب حينذاك برمجة لوحتك. يجب أن تُستدعَى توابعٌ مثل Mouse.move() و Keyboard.print() التي تحرك مؤشر الفأرة أو ترسل ضغات مفاتيحٍ إلى الحاسوب المتصل عندما تكون مستعدًا معالجتها والتعامل معها فقط. يُنصَح باستعمال نظام تحكم (control system) لتشغيل هذه الوظائف مثل استعمال قاطعة أو زر أو الاستجابة إلى مدخلات محدَّدة يمكنك التحكم بها فقط. يوجد في الأسفل عدة أمثلة عن الفأرة ولوحة المفاتيح للتعرف على بعض طرائق التعامل معهما.
عند استعمال مكتبة الفأرة ولوحة المفاتيح، يُفضَل فحص المخرجات أولًا باستعمال التابع ()Serial.print. تستطيع بهذه الطريقة التحقق والتأكد من القيم الناتجة.
begin()
يبدأ التابع عملية محاكاة (emulating) للوحة مفاتيح افتراضية موصولة بالحاسوب المتصل باللوحة Leonardo أو Due.
end()
يوقف التابع عملية محاكاة (emulating) وصل لوحة المفاتيح الافتراضية بالحاسوب المتصل باللوحة.
press()
يسلك التابع عند استدعائها نفس سلوك عملية الضغط على زرٍ في لوحة المفاتيح باستمرار.
print()
يرسل التابع ضغطة أو عدة ضغطات من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل.
println()
يرسل التابع ضغطة أو عدة ضغطات من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل ثمَّ يُتبِعها بمحرف سطر جديد ومحرف العودة إلى بداية السطر.
release()
يحرِّر التابع مفتاحًا محدَّدًا ضُغِط عليه مسبقًا باستعمال التابع press().
releaseAll()
يحرِّر التابع جميع المفاتيح التي ضُغِط عليها مسبقًا باستعمال التابع press().
write()
يرسل التابع ضغطة زر واحدة من لوحة المفاتيح الافتراضية إلى الحاسوب المتصل.
انظر أيضًا
- المكتبة Mouse.
- مثال: التحكم بلوحة المفاتيح والفأرة في برنامج واحد.
- مثال: إرسال رسالة عبر لوحة المفاتيح.
- مثال: تسجيل خروج المستخدم الحالي باستعمال لوحة المفاتيح.
- مثال: استعمال لوحة المفاتيح مع واجهة الاتصال التسلسلية.
- مثال: استعمال لوحة المفاتيح في إعادة برمجة لوحة أردوينو.