واجهة أتمتة عنصر تحكم نقش للعملاء

مقالة
11/01/2010

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

يقدم هذا العرض العام عنصر تحكم نقوش ل عملاء "التنفيذ التلقائي لواجهة المستخدم". يتضمن معلومات حول كيفية استخدام "التنفيذ التلقائي لواجهة مستخدم" عميل عنصر تحكم نقوش للوصول إلى معلومات حول واجهة المستخدم (UI).

أنماط عنصر تحكم يوفر طريقة إلى تصنيف وعرض الأداء الوظيفي مستقلة عن نوع عنصر التحكم أو المظهر عنصر التحكم لعنصر التحكم. عملاء "التنفيذ التلقائي لواجهة المستخدم" يمكن فحص AutomationElementلتحديد عنصر تحكم النقوش المعتمدة والتأكد من أن سلوك من عنصر تحكم.

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

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

الحصول على نقش عنصر تحكم
يتم الآن استرداد خصائص تشغيل نقش عنصر تحكم
أنماط مع متغير عناصر التحكم
موضوعات ذات صلة

الحصول على نقش عنصر تحكم

عملاء استرداد نمط عنصر التحكم من AutomationElementبواسطة استدعاء أما AutomationElement.GetCachedPatternأو AutomationElement.GetCurrentPattern.

يمكن للعملاء استخدام GetSupportedPatternsأسلوب أو فرد IsPatternAvailableخاصية (تشغيل سبيل المثال، IsTextPatternAvailableProperty) لتحديد ما إذا كان النقش أو مجموعة من النقوش هو معتمدة تشغيل AutomationElement. ومع ذلك، فإنه هو أكثر فعالية لمحاولة يحصل نمط عنصر التحكم واختبار nullالمرجع فحص من خصائص المعتمدة واسترداد نمط عنصر التحكم حيث أنه يؤدي المكالمات عبر العمليات أقل.

يوضح المثال التالي كيفية يحصل TextPatternعنصر تحكم النقش من AutomationElement.

// Specify the control type we're looking for, in this case 'Document'
PropertyCondition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);

// target --> The root AutomationElement.
AutomationElement textProvider = target.FindFirst(TreeScope.Descendants, cond);

targetTextPattern = textProvider.GetCurrentPattern(TextPattern.Pattern) as TextPattern;

if (targetTextPattern == null)
{
    Console.WriteLine("Root element does not contain a descendant that supports TextPattern.");
    return;
}

يتم الآن استرداد خصائص تشغيل نقش عنصر تحكم

يمكن لعملاء استرداد قيم الخصائص تشغيل عنصر تحكم نقوش بواسطة استدعاء أما AutomationElement.GetCachedPropertyValueأو AutomationElement.GetCurrentPropertyValueوالنوع إرجاع الكائن إلى عنصر النوع المناسب. للحصول تشغيل مزيد من المعلومات حول UI Automationخصائص، راجع واجه المستخدم أتمتة خصائص للعملاء.

في الإضافة إلى GetPropertyValueالطرق، يمكن استرداد قيم الخصائص من خلال وقت تشغيل اللغة العامة (CLR)accessors للوصول إلى UI Automationالخصائص تشغيل نقش.

أنماط مع متغير عناصر التحكم

بعض عنصر تحكم تعتمد أنواع النقوش مختلفة بالاعتماد تشغيل حالتها أو بالطريقة التي عنصر تحكم قيد الاستخدام. أمثلة عناصر التحكم التي يمكن أن يكون المتغير النقوش طرق عرض قائمة (الصور المصغرة أو إطارات متجانبة، الرموز، قائمة أو تفاصيل)، Microsoft Excelمخططات (دائري، خطي، شريط المهام، "القيمة خلية" باستخدام صيغة)، برنامج Microsoft Wordللمستند ناحية معاينة (عادي، "تخطيط ويب"، مخطط تفصيلي، تخطيط طباعة، قبل طباعة)، و Microsoft Windows Media Playerأسطح خارجية.

تطبيق مخصص عنصر تحكم s عنصر تحكم أنواع يمكن أن يكون لأي التعيين من عنصر تحكم نقوش المطلوبة لتمثيل TV.

راجع أيضًا:

واجهة أتمتة عنصر تحكم نقش للعملاء

الحصول على نقش عنصر تحكم

يتم الآن استرداد خصائص تشغيل نقش عنصر تحكم

أنماط مع متغير عناصر التحكم

راجع أيضًا:

المهام

المبادئ

موارد أخرى

الموارد الإضافية