واجه المستخدم أتمتة الدعم لنوع عنصر تحكم Menواجه المستخدمtem

مقالة
11/01/2010

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

يوفر هذا الموضوع معلومات حول Microsoft UI Automationدعم MenuItem عنصر تحكم نوع . فهو يصف عنصر التحكم Microsoft UI Automationبنية الشجرة ويوفر الخصائص و أنماط التحكم غير مطلوب ل MenuItem التحكم في نوع.

يسمح عنصر تحكم قائمة hierarchal المؤسسة من العناصر المرتبطة بالأوامر ومعالجات الأحداث. في نموذجية Microsoft Windowsتطبيق، وشريط القوائم يحتوي على عدة عناصر القائمة (مثل ملف و تحرير الإطار)، وإظهار كل عنصر في القائمة قائمة. تتضمن قائمة بمجموعة من عناصر القوائم (مثل جديد فتح و إغلاق )، والتي يمكن توسيعها إلى عرض عناصر القائمة إضافى أو تنفيذ إجراء محدد عند النقر فوقه. أ عنصر القائمة يمكن استضافة في القائمة أو شريط القوائم أو شريط الأدوات.

تعريف الأقسام التالية مطلوبة UI Automationالبنية الشجرية، الخصائص، عنصر تحكم النقوش وأحداث MenuItem عنصر تحكم النوع. UI Automationتطبيق متطلبات إلى الجميع قائمة عناصر التحكم، وما إذا كان Windows Presentation Foundation (WPF)، Win32، أو Windows Forms.

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

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

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

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

عنصر تحكم عرض	محتوى عرض
MenuItem "تعليمات" القائمة (قائمة فرعية من تعليمات عنصر القائمة) MenuItem "مواضيع التعليمات" MenuItem "حول"برنامج المفكره""	MenuItem "تعليمات" MenuItem "مواضيع التعليمات" MenuItem "حول"برنامج المفكره""

MenuItem "تعليمات"

القائمة (قائمة فرعية من تعليمات عنصر القائمة)
- MenuItem "مواضيع التعليمات"
- MenuItem "حول"برنامج المفكره""

MenuItem "تعليمات"

MenuItem "مواضيع التعليمات"
MenuItem "حول"برنامج المفكره""

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

لعرض محتويات قائمة هو غير موجود من UI Automationالشجرة لأنه لا نقل معلومات ذات معنى إلى مستخدم النهائي.

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

الجدول التالي lهوts UI Automationالخصائص ذات القيمة أو تعريف هو خاصة تتعلق بعناصر تحكم العنصر قائمة. للحصول تشغيل مزيد من المعلومات حول UI Automationخصائص، راجع واجه المستخدم أتمتة خصائص للعملاء.

الخصائص	Value	الوصف
AutomationIdProperty	راجع ملاحظات.	يجب أن يكون فريداً عبر الجميع عناصر التحكم في تطبيق القيمة هذه خاصية.
BoundingRectangleProperty	راجع ملاحظات.	الأكثر أهمية المستطيل الذي يحتوي على الكل عنصر تحكم.
ClickablePointProperty	راجع ملاحظات.	معتمد إذا كان هناك هو مستطيل إحاطة. إذا لم كل يؤشر ضمن المستطيل إحاطة هو قابلة للنقر، وإجراء اختبار دخول متخصصة ثم يمنع وتوفر يؤشر قابلة للنقر.
IsKeyboardFocusableProperty	راجع ملاحظات.	إذا كانت عنصر تحكم يمكن تلقي تركيز على لوحة المفاتيح، يجب أن يدعم هذه خاصية.
NameProperty	راجع ملاحظات.	يتم مُضمن عنصر تحكم لعنصر قائمة في طريقة عرض المحتوى UI Automationوالشجره وهي ذاتية تسميتها بالاسم.
LabeledByProperty	Null	لا توجد بطاقة العنونة.
ControlTypeProperty	MenuItem	Th هو قيمة هو نفسها لكافة الإطارات واجهة المستخدم.
LocalizedControlTypeProperty	"عنصر القائمة"	سلسلة مترجمة MenuItem التي تطابق عنصر تحكم النوع.
IsContentElementProperty	True	عنصر تحكم للقائمة هو عدم مُضمن في طريقة عرض المحتوى في UI Automationشجرة.
IsControlElementProperty	True	عنصر القائمة عنصر تحكم يجب مُضمنها دوماً في عنصر تحكم عرض UI Automationشجرة.

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

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

نمط عنصر التحكم الخاصية	الدعم	ملاحظات
IExpandCollapseProvider	ويعتمد	إذا كانت عنصر تحكم يمكن موسّعها أو طيها، تنفيذ IExpandCollapseProvider.
IInvokeProvider	ويعتمد	إذا كانت عنصر تحكم لتنفيذ إجراء مفرد أو الأمر، تنفيذ IInvokeProvider.
IToggleProvider	ويعتمد	إذا كانت عنصر تحكم يمثل أحد خيارات التي يمكنك تشغيل أو إيقاف تشغيله، قم بتطبيق IToggleProvider.
ISelectionItemProvider	ويعتمد	إذا كان عنصر التحكم هو يستخدم لتحديد من lهوt الخيارات بين عناصر القائمة، تنفيذ ISelectionItemProvider.

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

يسرد الجدول التالي Microsoft UI Automationالأحداث المقترنة بعنصر قائمة عنصر تحكم.

الحدث	الدعم	التفسير
InvokedEvent	ويعتمد	يجب أن تكون مرفوع إذا كان عنصر تحكم يعتمد استدعاء نمط عنصر التحكم.
ToggleStatePropertyحدث تم تغييره للخاصية.	ويعتمد	يجب أن تكون مرفوع إذا كان عنصر تحكم يعتمد تبديل نمط عنصر التحكم.
ExpandCollapseStatePropertyحدث تم تغييره للخاصية.	ويعتمد	يجب أن تكون مرفوعة إذا كان يعتمد عنصر تحكم "توسيع طي" نمط عنصر التحكم.
ElementSelectedEvent	ويعتمد	لا يوجد.

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

يسرد الجدول التالي UI Automationيلزم أن تكون معتمدة من قبل عنصر قائمة الجميع الأحداث عناصر التحكم. لمزيد من معلومات تشغيل الأحداث، راجع واجه المستخدم أتمتة نظرة عامة حول الأحداث.

UI Automationحدث	دعم/القيمه	ملاحظات
InvokedEvent	ويعتمد	لا يوجد
ElementAddedToSelectionEvent	ويعتمد	لا يوجد
ElementRemovedFromSelectionEvent	ويعتمد	لا يوجد
ElementSelectedEvent	ويعتمد	لا يوجد
BoundingRectanglePropertyحدث تم تغييره للخاصية.	ضروري	لا يوجد
IsOffscreenPropertyحدث تم تغييره للخاصية.	ضروري	لا يوجد
IsEnabledPropertyحدث تم تغييره للخاصية.	ضروري	لا يوجد
ExpandCollapseStatePropertyحدث تم تغييره للخاصية.	ويعتمد	لا يوجد
ToggleStatePropertyحدث تم تغييره للخاصية.	ويعتمد	لا يوجد
AutomationFocusChangedEvent	ضروري	لا يوجد
StructureChangedEvent	ضروري	لا يوجد

المشاكل قديم

تبديل نمط سيكون فقط معتمدة عند Win32عنصر قائمة هو محددة ويمكن برمجياً تحديد المطلوبة لدعم تبديل نمط. لأن Win32لا يقوم عنصر قائمة كشف ما إذا كان لديه القدرة على محدد من وجود، سوف يتم "استدعاء نقش" معتمدة عند عنصر قائمة هو لا محدد. يتم إجراء استثناء إلى دائماً باعتماد "استدعاء نقش" حتى بالنسبة لعناصر قائمة التي يجب أن تعتمد فقط على إلى ggle نقش. Th هو هو حتى لا تصبح العملاء أعلم أن عنصر تم اعتماد "استدعاء نقش" (عندما كان عنصر قائمة غير محددة) لم يعد يدعم نقش بمجرد أن يصبح فيها إيداعه.