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

ملاحظةملاحظة

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

يصف هذا الموضوع كيفية Microsoft UI Automationأحداث مستخدمة بواسطة عملاء "التنفيذ التلقائي لواجهة المستخدم".

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

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

ملاحظةملاحظة

لا يفترض أن الجميع الأحداث المحتملة مرفوع بأحد Microsoft UI Automationالموفر.على سبيل المثال، يؤدي ليست الجميع التغييرات في خصائص الأحداث إلى يمكن رفع من قبل موفري الوكيل القياسية ل Windows Formsو Win32عناصر التحكم.

لعرض أكبر من UI Automationأحداث، راجع واجه المستخدم أتمتة نظرة عامة حول الأحداث.

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

  • الاشتراك فى الأحداث
  • موضوعات ذات صلة

الاشتراك فى الأحداث

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

Method

نوع حدث

الوسيطات نوع حدث

نوع التفويض

AddAutomationFocusChangedEventHandler

تغيير تركيز

AutomationFocusChangedEventArgs

AutomationFocusChangedEventHandler

AddAutomationPropertyChangedEventHandler

تغيير خاصية

AutomationPropertyChangedEventArgs

AutomationPropertyChangedEventHandler

AddStructureChangedEventHandler

تغيير بنية

StructureChangedEventArgs

StructureChangedEventHandler

AddAutomationEventHandler

الأخرى أحداث، المعرفة AutomationEvent

AutomationEventArgs أو WindowClosedEventArgs

AutomationEventHandler

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

ملاحظةملاحظة

لمعالجة أحداث إغلاق من النافذة، اكتب تحويل وسيطة التي هو التي تم تمريرها إلى معالج حدث ك WindowClosedEventArgs.لأن Microsoft UI Automationالعنصر للإطار لم تعد صالحة، لا يمكنك استخدام senderمعلمة إلى استرداد معلومات؛ استخدم GetRuntimeIdبدلاً من ذلك.

ملاحظة تنبيهتنبيه

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

تشغيل متوقَّف عن التشغيل، أو عند UI Automationأحداث لم تعد ذات أهمية إلى تطبيق، s Auإلىmation واجهة مستخدم عميل يجب استدعاء إحدى الطرق التالية.

Method

الوصف

RemoveAutomationEventHandler

unregisters معالج أحداث الذي كان مسجَّل باستخدام AddAutomationEventHandler.

RemoveAutomationFocusChangedEventHandler

unregisters معالج أحداث الذي كان مسجَّل باستخدام AddAutomationFocusChangedEventHandler.

RemoveAutomationPropertyChangedEventHandler

unregisters معالج أحداث الذي كان مسجَّل باستخدام AddAutomationPropertyChangedEventHandler.

RemoveAllEventHandlers

unregisters الجميع معالجات الأحداث المسجلة.

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

راجع أيضًا:

المهام

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

نموذج TrackFocus

المبادئ

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

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