KeyboardEvent

KeyboardEvent class

توفر واجهة KeyboardEvent معلومات سياقية محددة مرتبطة بأجهزة لوحة المفاتيح. يشير كل حدث لوحة مفاتيح إلى مفتاح يستخدم قيمة. يتم توجيه أحداث لوحة المفاتيح بشكل عام إلى العنصر الذي يتم التركيز عليه.

public class KeyboardEvent : UIEvent

المنشئون

اسم وصف
KeyboardEvent(string) يقوم بتهيئة مثيل جديد لملفKeyboardEvent فئة .
KeyboardEvent(string, IDictionary<string, object>) يقوم بتهيئة مثيل جديد لملفKeyboardEvent فئة .

الخصائص

اسم وصف
AltKey { get; } true إذا كان معدِّل المفتاح Alt (البديل) (أو “الخيار”) نشطًا. يجب أن تكون القيمة غير المهيأة لهذه السمة خاطئة.
Bubbles { get; } يُستخدم للإشارة إلى ما إذا كان الحدث عبارة عن حدث فقاعات أم لا. إذا كان الحدث يمكن أن ينبعث منه فقاعات ، تكون القيمة صحيحة ، وإلا تكون القيمة خاطئة.
Cancelable { get; } يُستخدم للإشارة إلى ما إذا كان يمكن منع إجراء افتراضي لحدث أم لا. إذا كان من الممكن منع الإجراء الافتراضي ، كانت القيمة صحيحة ، وإلا تكون القيمة خاطئة.
Code { get; } يحتفظ الرمز بسلسلة تحدد المفتاح الفعلي الذي يتم الضغط عليه. لا تتأثر القيمة بالتخطيط الحالي للوحة المفاتيح أو حالة التعديل ، لذلك سيعود مفتاح معين دائمًا بنفس القيمة.
CtrlKey { get; } صحيح إذا كان معدل مفتاح التحكم (عنصر التحكم) نشطًا. يجب أن تكون القيمة غير المهيأة لهذه السمة خاطئة.
CurrentTarget { get; } يُستخدم للإشارة إلى ملفIEventTarget ملك منIEventListener يتم حاليًا معالجة الصورة . هذا مفيد بشكل خاص أثناء الالتقاط والفقاعات.
DefaultPrevented { get; } إرجاع صحيح إذا تم استدعاء منع PreventionDefault () بينما تكون قيمة السمة القابلة للإلغاء صحيحة ، والخطأ في الحالات الأخرى.
Detail { get; } تحديد بعض المعلومات التفصيلية حول الحدث ، اعتمادًا على نوع الحدث.
EventPhase { get; } يُستخدم للإشارة إلى أي مرحلة من مراحل تدفق الأحداث يتم تقييمها حاليًا.
IsComposing { get; } true إذا حدث الحدث الرئيسي كجزء من جلسة تكوين ، أي بعد حدث مقطوعة موسيقية وقبل حدث التكوين المقابل. يجب أن تكون القيمة غير المهيأة لهذه السمة خاطئة.
IsTrusted { get; } يجب أن ترجع السمة isTrusted القيمة التي تمت تهيئتها إليها. عند إنشاء حدث ، يجب تهيئة السمة إلى false .
Key { get; } يحتفظ المفتاح بالقيمة الأساسية للمفتاح المضغوط. إذا كانت القيمة تحتوي على تمثيل مطبوع ، فيجب أن تكون سلسلة أحرف Unicode غير فارغة ، بما يتوافق مع الخوارزمية لتحديد قيمة المفتاح المحددة في هذه المواصفات. إذا كانت القيمة عبارة عن مفتاح تحكم ليس له تمثيل مطبوع ، فيجب أن تكون إحدى القيم الأساسية المحددة في مجموعة قيم المفاتيح ، على النحو الذي تحدده الخوارزمية لتحديد قيمة المفتاح. يجب أن تستخدم التطبيقات غير القادرة على تحديد مفتاح قيمة المفتاح غير محدد.
Location { get; } تحتوي سمة الموقع على إشارة إلى الموقع المنطقي للمفتاح على الجهاز.
MetaKey { get; } صحيح إذا كان معدِّل مفتاح التعريف (Meta) نشطًا.
Repeat { get; } صحيح إذا تم الضغط على المفتاح بطريقة مستمرة. يجب أن يؤدي الضغط باستمرار على مفتاح إلى تكرار keydown للأحداث ، قبل الإدخال ، والإدخال بهذا الترتيب ، بمعدل يحدده تكوين النظام. بالنسبة للأجهزة المحمولة التي تتمتع بسلوك الضغط على المفاتيح لفترة طويلة ، يجب أن يكون الحدث الرئيسي الأول الذي يحتوي على قيمة سمة متكررة للقيمة true بمثابة مؤشر على الضغط لفترة طويلة على المفاتيح. يعتمد طول الفترة الزمنية التي يجب أن يتم فيها الضغط على المفتاح لبدء التكرار على التكوين.
ShiftKey { get; } صحيح إذا كان معدِّل مفتاح Shift (Shift) نشطًا.
Target { get; } يُستخدم للإشارة إلى ملفIEventTarget الذي تم إرسال الحدث إليه في الأصل.
TimeStamp { get; } يُستخدم لتحديد الوقت (بالمللي ثانية بالنسبة للعصر) الذي تم فيه إنشاء الحدث . نظرًا لحقيقة أن بعض الأنظمة قد لا توفر هذه المعلومات ، فقد لا يكون الطابع الزمني متاحًا لجميع الأحداث. ، سيتم إرجاع القيمة 0. أمثلة على وقت الحقبة هي وقت بدء النظام أو 0: 0: 0 UTC 1 يناير 1970.
Type { get; } اسم الحدث (غير حساس لحالة الأحرف). يجب أن يكون الاسم اسم XML .
View { get; } تحدد سمة العرض النافذة التي تم إنشاء الحدث منها. يجب أن تكون القيمة غير المهيأة لهذه السمة خالية.

طُرق

اسم وصف
virtual GetPlatformType() تُستخدم هذه الطريقة لاسترداد كائن ECMAScriptType .
InitEvent(string, bool, bool) ملفInitEvent يتم استخدام طريقة لتهيئة قيمةEvent تم إنشاؤه من خلال IDocumentEvent الواجهة .
PreventDefault() إذا كان الحدث قابلاً للإلغاء ، فإن ملفPreventDefault يتم استخدام الطريقة للدلالة على أن الحدث سيتم إلغاؤه ، مما يعني أن أي إجراء افتراضي يتم اتخاذه عادةً بواسطة التنفيذ نتيجة للحدث لن يحدث.
StopImmediatePropagation() استدعاء هذه الطريقة يمنع الحدث من الوصول إلى أي مستمعين حدث مسجل بعد الحدث الحالي وعندما يتم إرساله في شجرة يمنع أيضًا الحدث من الوصول إلى أي كائنات أخرى.
StopPropagation() ملفStopPropagation الطريقة المستخدمة لمنع المزيد من الانتشار لحدث ما أثناء تدفق الحدث.

مجالات

اسم وصف
const DOM_KEY_LOCATION_LEFT نشأ المفتاح المنشط من موقع المفتاح الأيسر (عندما يكون هناك أكثر من موقع محتمل لهذا المفتاح) .
const DOM_KEY_LOCATION_NUMPAD نشأ تنشيط المفتاح على لوحة المفاتيح الرقمية أو باستخدام مفتاح افتراضي مطابق للوحة المفاتيح الرقمية (عندما يكون هناك أكثر من موقع واحد محتمل لهذا المفتاح). لاحظ أنه يجب دائمًا ترميز مفتاح NumLock بموقع DOM_KEY_LOCATION_STANDARD.
const DOM_KEY_LOCATION_RIGHT نشأ تنشيط المفتاح من موقع المفتاح الصحيح (عندما يكون هناك أكثر من موقع واحد محتمل لهذا المفتاح) .
const DOM_KEY_LOCATION_STANDARD يجب عدم تمييز تنشيط المفتاح باعتباره الإصدار الأيمن أو الأيسر من المفتاح ، و (بخلاف مفتاح NumLock) لم ينشأ من لوحة المفاتيح الرقمية (أو لم ينشأ بمفتاح افتراضي يتوافق مع لوحة المفاتيح الرقمية) .

أنظر أيضا