This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

AutomationElement.FindFirst أسلوب

Visual Studio 2010

إرجاع العنصر التابع أو فرع أول الذي يطابق المحدد شرط.

مساحة الاسم:  System.Windows.Automation
التجميع:  UIAutomationClient (في UIAutomationClient.dll)

public AutomationElement FindFirst(
	TreeScope scope,
	Condition condition
)

المعلمات

scope
النوع: System.Windows.Automation.TreeScope
تمثل مجموعة من قيم التي تحدد نطاق بحث.
condition
النوع: System.Windows.Automation.Condition
الكائن الذي يحتوي على الخصائص إلى مطابقة.

القيمة المُرجعة

النوع: System.Windows.Automation.AutomationElement
أول عنصر التي تفي بشرط، أو nullإذا تم العثور على أي تطابق.

نطاق بحث هو نسبة إلى العنصر الذي الأسلوب هو المسمى.

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

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

يظهر المثال التالي كيفية بحث نافذة فرعي من المعرف الخاص به.


/// <summary>
/// Find a UI Automation child element by ID.
/// </summary>
/// <param name="controlName">Name of the control, such as "button1"</param>
/// <param name="parentElement">Parent element, such as an application window, or the 
/// AutomationElement.RootElement when searching for the application window.</param>
/// <returns>The UI Automation element.</returns>
private AutomationElement FindChildElement(String controlName, AutomationElement rootElement)
{
    if ((controlName == "") || (rootElement == null))
    {
        throw new ArgumentException("Argument cannot be null or empty.");
    }
    // Set a property condition that will be used to find the main form of the
    // target application. In the case of a WinForms control, the name of the control
    // is also the AutomationId of the element representing the control.
    Condition propCondition = new PropertyCondition(
        AutomationElement.AutomationIdProperty, controlName, PropertyConditionFlags.IgnoreCase);

    // Find the element.
    return rootElement.FindFirst(TreeScope.Element | TreeScope.Children, propCondition);
}


نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008, نظام التشغيل Windows Server 2003

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0

NET Framework. Client Profile

مدعوم في: 4
إظهار: