AutomationElement.CachedChildren Vlastnost

Definice

Obor názvů:

System.Windows.Automation

Sestavení:

UIAutomationClient.dll

Získá podřízené prvky mezipaměti tohoto AutomationElementobjektu .

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

Hodnota vlastnosti

AutomationElementCollection

Kolekce podřízených prvků. Tato kolekce může být prázdná, pokud prvek nemá žádné podřízené položky.

Výjimky

ElementNotAvailableException

Uživatelské rozhraní pro objekt AutomationElement už neexistuje.

InvalidOperationException

Nebyl proveden žádný požadavek na ukládání podřízených položek tohoto prvku do mezipaměti.

Příklady

V následujícím příkladu je element seznamu získán z nadřazeného elementu okna, zatímco CacheRequest je aktivní a TreeScope je Children. Zadané vlastnosti podřízených prvků (tj. položek seznamu) jsou uloženy v mezipaměti a lze je načíst ze CachedChildren seznamu.

/// <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

Poznámky

Zobrazení vrácené kolekce je určeno podmínkou TreeFilterCacheRequest , která byla aktivní při získání tohoto AutomationElement objektu.

Podřízené položky se ukládají do mezipaměti pouze v případě, že je CacheRequest zahrnut Subtreerozsah , Childrennebo Descendants.

Pokud je CacheRequest zadáno, že podřízené položky se mají ukládat do mezipaměti na této úrovni, ale neexistují žádné podřízené položky, pak je hodnota této vlastnosti 0. Pokud však nebyl proveden žádný požadavek na ukládání podřízených položek do mezipaměti na této úrovni, pokus o načtení vlastnosti vyvolá výjimku.

Viz také

• Práce s mezipamětí u klientů automatizace uživatelského rozhraní