AutomationElement.CachedChildren Propriété

Définition

Espace de noms:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Obtient les éléments enfants mis en cache de ce AutomationElement.

public:
 property System::Windows::Automation::AutomationElementCollection ^ CachedChildren { System::Windows::Automation::AutomationElementCollection ^ get(); };

public System.Windows.Automation.AutomationElementCollection CachedChildren { get; }

member this.CachedChildren : System.Windows.Automation.AutomationElementCollection

Public ReadOnly Property CachedChildren As AutomationElementCollection

Valeur de propriété

AutomationElementCollection

Collection d’éléments enfants. Cette collection peut être vide si l’élément n’a pas d’enfants.

Exceptions

ElementNotAvailableException

L’interface utilisateur pour AutomationElement n’existe plus.

InvalidOperationException

Aucune requête n'a été faite pour mettre en cache les enfants de cet élément.

Exemples

Dans l’exemple suivant, un élément de zone de liste est obtenu à partir de l’élément de fenêtre parent alors qu’il CacheRequest est actif et TreeScope est Children. Les propriétés spécifiées des éléments enfants (autrement dit, les éléments de liste) sont stockées dans le cache et peuvent être récupérées à partir de la CachedChildren zone de liste.

/// <summary>
/// Gets a list box element and caches the Name property of its children (the list items).
/// </summary>
/// <param name="elementMain">The UI Automation element for the parent window.</param>
void CachePropertiesWithScope(AutomationElement elementMain)
{
    AutomationElement elementList;

    // Set up the CacheRequest.
    CacheRequest cacheRequest = new CacheRequest();
    cacheRequest.Add(AutomationElement.NameProperty);
    cacheRequest.TreeScope = TreeScope.Element | TreeScope.Children;

    // Activate the CacheRequest and get the element. Note that the scope of the CacheRequest
    // is in relation to the object being retrieved: the list box and its children are 
    // cached, not the main window and its children.
    using (cacheRequest.Activate())
    {
        // Load the list element and cache the specified properties for its descendants.
        Condition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.List);
        elementList = elementMain.FindFirst(TreeScope.Children, cond);
    }
    if (elementList == null) return;

    // The following illustrates that the children of the list are in the cache.
    foreach (AutomationElement listItem in elementList.CachedChildren)
    {
        Console.WriteLine(listItem.Cached.Name);
    }

    // The following call raises an exception, because the IsEnabled property was not cached.
    /*** Console.WriteLine(listItem.Cached.IsEnabled); ***/

    // The following illustrates that because the list box itself was cached, it is now
    // available as the CachedParent of each list item.
    AutomationElement child = elementList.CachedChildren[0];
    Console.WriteLine(child.CachedParent.Cached.Name);
}

''' <summary>
''' Gets a list box element and caches the Name property of its children (the list items).
''' </summary>
''' <param name="elementMain">The UI Automation element for the parent window.</param>
Sub CachePropertiesWithScope(ByVal elementMain As AutomationElement)
    Dim elementList As AutomationElement

    ' Set up the CacheRequest.
    Dim cacheRequest As New CacheRequest()
    cacheRequest.Add(AutomationElement.NameProperty)
    cacheRequest.TreeScope = TreeScope.Element Or TreeScope.Children

    ' Activate the CacheRequest and get the element. Note that the scope of the CacheRequest
    ' is in relation to the object being retrieved: the list box and its children are 
    ' cached, not the main window and its children.
    Using cacheRequest.Activate()
        ' Load the list element and cache the specified properties for its descendants.
        Dim myCondition As New PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.List)
        elementList = elementMain.FindFirst(TreeScope.Children, myCondition)

        If elementList Is Nothing Then
            Return
        End If

        ' The following illustrates that the children of the list are in the cache.
        Dim listItem As AutomationElement
        For Each listItem In elementList.CachedChildren
            Console.WriteLine(listItem.Cached.Name)
        Next listItem

        ' The following call raises an exception, because the IsEnabled property was not cached.
        '** Console.WriteLine(listItem.Cached.IsEnabled) **

        ' The following illustrates that because the list box itself was cached, it is now
        ' available as the CachedParent of each list item.
        Dim child As AutomationElement = elementList.CachedChildren(0)
        Console.WriteLine(child.CachedParent.Cached.Name)
    End Using
End Sub

Remarques

La vue de la collection retournée est déterminée par la TreeFilter condition de l’objet CacheRequest actif lors de l’obtention de cet AutomationElement objet.

Les enfants sont mis en cache uniquement si l’étendue de l’élément CacheRequest inclus Subtree, Childrenou Descendants.

Si les CacheRequest enfants devaient être mis en cache à ce niveau, mais qu’il n’y a pas d’enfants, la valeur de cette propriété est 0. Toutefois, si aucune demande n’a été faite pour mettre en cache les enfants à ce niveau, une tentative de récupération de la propriété déclenche une exception.

Voir aussi

• Mise en cache dans les clients UI Automation