واجه المستخدم أتمتة نظرة عامة حول الأحداث

ملاحظة
Th هو الوثائق هو المقصودة لإطار عمل.NET المطورين الذين يرغبون في استخدام المدارة UI Automationالفئات المعرفة في System.Windows.Automationمساحة الاسم.للحصول على أحدث المعلومات حول UI Automation، راجع API التنفيذ التلقائي Windows: أتمتة واجه المستخدم.

Microsoft UI Automationإعلام حدث هو ميزة أساسية لتقنيات assهوtive مثل قارئات شاشة ومكبرات شاشة. هذه عملاء واجهة المستخدم Auإلىmation مقطع صوتي الأحداث التي يتم مرفوع قبل موفري واجهة المستخدم Auإلىmation عند حدث شيء ما في واجهة المستخدمواستخدام المعلومات إلى بإعلام المستخدمين النهائيين.

فعالية هو تحسين بالسماح للتطبيقات موفر أحداث raهوe بشكل انتقائي، استناداً إلى ما إذا كان أي عملاء يتم الاشتراك لهذه الأحداث، أو غير الإطلاق، إذا كان لا يوجد عملاء lهوtening لأية أحداث.

يشتمل هذا الموضوع على الأقسام التالية.

• أنواع أحداث
• التنفيذ التلقائي حدث معرفات واجهة المستخدم
• وسيطات حدث التنفيذ التلقائي واجهة المستخدم
• موضوعات ذات صلة

أنواع أحداث

UI Automationأحداث تقع في الفئات التالية.

الحدث	الوصف
تغيير خاصية	مرفوع عند خاصية في UI Automationالعنصر أو نمط عنصر التحكم تغييرات. تشغيل سبيل المثال، إذا كان عميل بحاجة إلى مراقبة الاختيار الخاص بالتطبيق صندوق عنصر التحكم، فإنه يمكن تسجيل للاستماع لحدث تغيير خاصية تشغيل ToggleStateالخاصية. عندما مربع الاختيار لعنصر التحكم هو أو إلغاء تحديدها، raهوes الموفر حدث والعميل يمكن العمل كلما دعت الضرورة.
عنصر إجراء	Raهوed عند حدوث تغيير في واجهة المستخدمناتجة عن مستخدم النهائي أو نشاط المبرمج؛ على سبيل المثال، عند زر هو النقر فوقه أو قم باستدعاء من خلال InvokePattern.
تغيير بنية	مرفوع عند بنية UI Automationشجرة التغييرات. تغيير البنية عندما واجهة المستخدمتصبح عناصر المرئية أو المخفية، أو تمت إزالتها من تشغيل " جديد سطح المكتب.
تغيير سطح المكتب العام	مرفوع عند تنفيذ الالاجراءات ذات أهمية عمومي للعميل، مثل عندما يتم نقل تركيز من واحد عنصر إلى آخر، أو عند إغلاق أحد النافذةات.

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

قد يمكن رفع الأحداث التالية حتى عند الالولاية واجه المستخدم لم تتغير.

• AutomationPropertyChangedEvent(وذلك استناداً إلى خاصية التي تم تم تغييره)

• ElementSelectedEvent

• InvalidatedEvent

• TextChangedEvent

التنفيذ التلقائي حدث معرفات واجهة المستخدم

Microsoft UI Automationيتم تعريف الأحداث بواسطةAutomationEventالكائنات. Idتحتوي خاصية على القيمة الذي يعرف بشكل فريد نوع حدث.

قيم المحتملة ل Idالمعطاة في الجدول التالي، بالإضافة إلى نوع المستخدمة للحدث الوسيطات. لاحظ أن معرفات المستخدمة من قبل عملاء وموفري المثل تسمية حقول من فئات مختلفة.

معرّف العميل	معرّف الموفر	الوسيطات نوع حدث
AutomationElement.AsyncContentLoadedEvent	AutomationElementIdentifiers.AsyncContentLoadedEvent	AsyncContentLoadedEventArgs
SelectionItemPattern.ElementAddedToSelectionEvent SelectionItemPattern.ElementRemovedFromSelectionEvent SelectionItemPattern.ElementSelectedEvent SelectionPattern.InvalidatedEvent InvokePattern.InvokedEvent AutomationElement.LayoutInvalidatedEvent AutomationElement.MenuClosedEvent AutomationElement.MenuOpenedEvent TextPattern.TextChangedEvent TextPattern.TextSelectionChangedEvent AutomationElement.ToolTipClosedEvent AutomationElement.ToolTipOpenedEvent WindowPattern.WindowOpenedEvent	SelectionItemPatternIdentifiers.ElementAddedToSelectionEvent SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent SelectionItemPatternIdentifiers.ElementSelectedEvent SelectionPatternIdentifiers.InvalidatedEvent InvokePatternIdentifiers.InvokedEvent AutomationElementIdentifiers.LayoutInvalidatedEvent AutomationElementIdentifiers.MenuClosedEvent AutomationElementIdentifiers.MenuOpenedEvent TextPatternIdentifiers.TextChangedEvent TextPatternIdentifiers.TextSelectionChangedEvent AutomationElementIdentifiers.ToolTipClosedEvent AutomationElementIdentifiers.ToolTipOpenedEvent WindowPatternIdentifiers.WindowOpenedEvent	AutomationEventArgs
AutomationElement.AutomationFocusChangedEvent	AutomationElementIdentifiers.AutomationFocusChangedEvent	AutomationFocusChangedEventArgs
AutomationElement.AutomationPropertyChangedEvent	AutomationElementIdentifiers.AutomationPropertyChangedEvent	AutomationPropertyChangedEventArgs
AutomationElement.StructureChangedEvent	AutomationElementIdentifiers.StructureChangedEvent	StructureChangedEventArgs
WindowPattern.WindowClosedEvent	WindowPatternIdentifiers.WindowClosedEvent	WindowClosedEventArgs

وسيطات حدث التنفيذ التلقائي واجهة المستخدم

فئات التالية تغليف وسائط حدث.

الفئة	الوصف
AsyncContentLoadedEventArgs	يحتوي على معلومات حول التحميل غير المتزامن للمحتوى، بما في ذلك نسبة اكتمال التحميل.
AutomationEventArgs	يحتوي على معلومات حول حدث بسيط يتطلب عدم وجود بيانات إضافية.
AutomationFocusChangedEventArgs	يحتوي على معلومات حول تغيير في تركيز إدخال من عنصر إلى آخر. يتم مرفوع أحداث من هذا النوع قبل UI Automationالنظام، وليس بواسطة موفري خدمات.
AutomationPropertyChangedEventArgs	يحتوي على معلومات حول تغيير القيمة خاصية من أحد النقوش عنصر أو عنصر التحكم.
StructureChangedEventArgs	يحتوي على معلومات حول تغيير في UI Automationشجرة.
WindowClosedEventArgs	يحتوي على معلومات حول إغلاق نافذة.

يحتوي على الجميع فئات الأحداث للوسيطة على EventIdالعضو. يتم تغليف هذا المعرف في AutomationEvent.

AutomationEventالكائنات تستخدم لتعريف الأحداث التي تم الحصول عليها بواسطة موفري من حقول في AutomationElementIdentifiersو نمط عنصر التحكم المعرّف فئات مثل DockPatternIdentifiers. حقول المكافئة يتم الحصول عليها من قبل تطبيقات عميل من حقول في AutomationElementو نمط عنصر التحكم الفئات مثل DockPattern.

للحصول على قائمة بمعرفات الأحداث، راجع واجه المستخدم أتمتة الأحداث للعملاء.

راجع أيضًا:

المهام

الاشتراك في أحداث Auإلىmation إلى واجهة المستخدم

المبادئ

واجه المستخدم أتمتة الأحداث للعملاء

تطبيق موفر التنفيذ التلقائي لواجهة المستخدم من جانب الخادم