AutomationElement.FindFirst(TreeScope, Condition) Méthode

Définition

Retourne le premier élément enfant ou descendant qui correspond à la condition spécifiée.

C#
public System.Windows.Automation.AutomationElement FindFirst (System.Windows.Automation.TreeScope scope, System.Windows.Automation.Condition condition);

Paramètres

scope
TreeScope

Combinaison d'opérations de bits de valeurs qui spécifient la portée de la recherche.

condition
Condition

Objet contenant les critères à satisfaire.

Retours

Premier élément qui satisfait la condition, ou null si aucune correspondance n'est trouvée.

Exemples

L’exemple suivant montre comment rechercher une fenêtre enfant à partir de son identificateur.

C#
/// <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);
}

Remarques

L’étendue de la recherche est relative à l’élément sur lequel la méthode est appelée.

Lorsque vous recherchez une fenêtre de niveau supérieur sur le bureau, veillez à spécifier Children dans scope, et non Descendantsdans . Une recherche dans l’ensemble de la sous-arborescence du bureau peut itérer à travers des milliers d’éléments et entraîner un dépassement de capacité de la pile.

Si votre application cliente peut essayer de trouver des éléments dans sa propre interface utilisateur, vous devez effectuer tous les appels UI Automation sur un thread distinct.

S’applique à

Produit Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Voir aussi