الفرق بين المراجعتين لصفحة: «Arduino/mouse»

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

تتيح توابع المكتبة Mouse إمكانية تحكم اللوحات التي تعتمد على متحكمات 32u4 أو SAMD بمؤشر الفأرة في الحاسوب المتصل عبر المنفذ USB الأصلي للمتحكم. يكون موقع مؤشر الفأرة نسبي دومًا؛ فعند تحديث موقع مؤشر الفأرة الحالي وتحريكه، ينتقل المؤشر إلى الموقع الجديد نسبةً إلى موقعه القديم.

تسمح المكتبات الأساسية للوحات التي ترتكز على متحكمات 32u4 و SAMD (مثل عائلة Leonardo، و Esplora، و Zero، و Due، و MKR) بجعل الفأرة و/أو لوحة المفاتيح تبدوان عند وصلهما بالحاسوب وكأنَّهما أصليتان.

هنالك تحذير واحد عند استعمال مكتبات الفأرة ولوحة المفاتيح هو أنَّه إذا كانت المكتبة تعمل بشكل متواصل، فسيكون من الصعب حينذاك برمجة لوحتك. يجب أن تُستدعَى توابعٌ مثل Mouse.move()‎ و Keyboard.print()‎ التي تحرك مؤشر الفأرة أو ترسل ضغات مفاتيحٍ إلى الحاسوب المتصل عندما تكون مستعدًا معالجتها والتعامل معها فقط. يُنصَح باستعمال نظام تحكم (control system) لتشغيل هذه الوظائف مثل استعمال قاطعة أو زر أو الاستجابة إلى مدخلات محدَّدة يمكنك التحكم بها فقط. يوجد في الأسفل عدة أمثلة عن الفأرة ولوحة المفاتيح للتعرف على بعض طرائق التعامل معهما.

عند استعمال مكتبة الفأرة ولوحة المفاتيح، يُفضَل فحص المخرجات أولًا باستعمال التابع ()Serial.print. تستطيع بهذه الطريقة التحقق والتأكد من القيم الناتجة.

`begin()‎`

يبدأ التابع عملية محاكاة (emulating) لفأرة افتراضية موصولة بالحاسوب المتصل.

`click()‎`

يرسل التابع ضغطة سريعة وخاطفة إلى الحاسوب عند موقع مؤشر الفأرة الحالي.

`end()‎`

يوقف التابع عملية محاكاة (emulating) وصل فأرة افتراضية بالحاسوب المتصل.

`move()‎`

يحرك التابع مؤشر الفأرة في الحاسوب المتصل.

`press()‎`

يرسل التابع ضغطة مستمرة إلى الحاسوب عند موقع مؤشر الفأرة الحالي.

`release()‎`

يحرِّر التابع زر الفأرة الذي ضُغِط عليه مسبقًا باستعمال التابع press()‎.

`isPressed()‎`

يتحقَّق التابع إن كان زر معيَّن من أزرار الفأرة مضغوطًا أم لا.

انظر أيضًا

المكتبة Keyboard.

مثال: التحكم بلوحة المفاتيح والفأرة في برنامج واحد.
مثال: التحكم بمؤشر الفأرة باستعمال 5 أزرار.
مثال: التحكم بمؤشر الفأرة باستعمال عصا تحكم.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:المكتبة Mouse في أردوينو}}</noinclude>
-تتيح دوال المكتبة Mouse إمكانية تحكم اللوحات التي تعتمد على متحكمات 32u4 أو SAMD بمؤشر الفأرة في الحاسوب المتصل عبر المنفذ USB الأصلي للمتحكم. يكون موقع مؤشر الفأرة نسبي دومًا؛ فعند تحديث موقع مؤشر الفأرة الحالي وتحريكه، ينتقل المؤشر إلى الموقع الجديد نسبةً إلى موقعه القديم.
+تتيح توابع المكتبة Mouse إمكانية تحكم اللوحات التي تعتمد على متحكمات 32u4 أو SAMD بمؤشر الفأرة في الحاسوب المتصل عبر المنفذ USB الأصلي للمتحكم. يكون موقع مؤشر الفأرة نسبي دومًا؛ فعند تحديث موقع مؤشر الفأرة الحالي وتحريكه، ينتقل المؤشر إلى الموقع الجديد نسبةً إلى موقعه القديم.
+__TOC__
 تسمح المكتبات الأساسية للوحات التي ترتكز على متحكمات 32u4 و SAMD (مثل عائلة Leonardo، و Esplora، و Zero، و Due، و MKR) بجعل الفأرة و/أو لوحة المفاتيح تبدوان عند وصلهما بالحاسوب وكأنَّهما أصليتان.
-هنالك '''تحذير''' واحد عند استعمال مكتبات الفأرة و<nowiki/>[[Arduino/keyboard|لوحة المفاتيح]] هو أنَّه إذا كانت المكتبة تعمل بشكل متواصل، فسيكون من الصعب حينذاك برمجة لوحتك. يجب أن تُستدعَى دوالٌ مثل <nowiki/>[[Arduino/mouse/mousemove|<code>Mouse.move()</code>‎]] و <code>[[Arduino/keyboard/keyboardprint|Keyboard.print()]]‎</code> التي تحرك مؤشر الفأرة أو ترسل ضغات مفاتيحٍ إلى الحاسوب المتصل عندما تكون مستعدًا لمعالجتها والتعامل معها فقط. يُنصَح باستعمال نظام تحكم (control system) لتشغيل هذه الوظائف مثل استعمال قاطعة أو زر أو الاستجابة إلى مدخلات محدَّدة يمكنك التحكم بها فقط. يوجد في الأسفل عدة أمثلة عن الفأرة ولوحة المفاتيح ننصحك بالاطلاع عليها للتعرف على بعض طرائق التعامل معهما.
+هنالك '''تحذير''' واحد عند استعمال مكتبات [[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/serial/print|()Serial.print]]</code>. تستطيع بهذه الطريقة التحقق والتأكد من القيم الناتجة.
 ==<code>[[Arduino/mouse/mousebegin|begin()‎]]</code>==
-تبدأ الدالة <code>begin()‎</code> عملية محاكاة (emulating) لفأرة افتراضية موصولة بالحاسوب المتصل.
+يبدأ التابع عملية محاكاة (emulating) لفأرة افتراضية موصولة بالحاسوب المتصل.
 ==<code>[[Arduino/mouse/mouseclick|click()‎]]</code>==
-ترسل الدالة <code>click()‎</code> ضغطة سريعة وخاطفة إلى الحاسوب عند موقع مؤشر الفأرة الحالي.
+يرسل التابع ضغطة سريعة وخاطفة إلى الحاسوب عند موقع مؤشر الفأرة الحالي.
 ==<code>[[Arduino/mouse/mouseend|end()‎]]</code>==
-توقف الدالة <code>end()‎</code> عملية محاكاة (emulating) وصل فأرة افتراضية بالحاسوب المتصل.
+يوقف التابع عملية محاكاة (emulating) وصل فأرة افتراضية بالحاسوب المتصل.
 ==<code>[[Arduino/mouse/mousemove|move()‎]]</code>==
-تحرك الدالة <code>move()‎</code> مؤشر الفأرة في الحاسوب المتصل.
+يحرك التابع مؤشر الفأرة في الحاسوب المتصل.
 ==<code>[[Arduino/mouse/mousepress|press()‎]]</code>==
-ترسل الدالة <code>press()‎</code> ضغطة مستمرة إلى الحاسوب عند موقع مؤشر الفأرة الحالي.
+يرسل التابع ضغطة مستمرة إلى الحاسوب عند موقع مؤشر الفأرة الحالي.
 ==<code>[[Arduino/mouse/mouserelease|release()‎]]</code>==
-تحرِّر الدالة <code>release()‎</code> زر الفأرة الذي ضُغِط عليه مسبقًا باستعمال الدالة <code>[[Arduino/mouse/mousepress|press()‎]]</code>.
+يحرِّر التابع  زر الفأرة الذي ضُغِط عليه مسبقًا باستعمال التابع <code>[[Arduino/mouse/mousepress|press()‎]]</code>.
 ==<code>[[Arduino/mouse/mouseispressed|isPressed()‎]]</code>==
-تتحقَّق الدالة <code>isPressed()‎</code> إن كان زر معيَّن من أزرار الفأرة مضغوطًا أم لا.
+يتحقَّق التابع إن كان زر معيَّن من أزرار الفأرة مضغوطًا أم لا.
 == انظر أيضًا ==