AutomationElement.Cached Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Automation
Assembly:
UIAutomationClient.dll

Ruft die zwischengespeicherten Benutzeroberflächenautomatisierung Eigenschaftenwerte für dieses AutomationElement Objekt ab.

public:
 property System::Windows::Automation::AutomationElement::AutomationElementInformation Cached { System::Windows::Automation::AutomationElement::AutomationElementInformation get(); };
public System.Windows.Automation.AutomationElement.AutomationElementInformation Cached { get; }
member this.Cached : System.Windows.Automation.AutomationElement.AutomationElementInformation
Public ReadOnly Property Cached As AutomationElement.AutomationElementInformation

Eigenschaftswert

AutomationElement.AutomationElementInformation

Eine Struktur, die die zwischengespeicherten Eigenschaftswerte für das AutomationElement enthält.

Ausnahmen

InvalidOperationException

Es sind keine zwischengespeicherten Eigenschaften vorhanden.

ElementNotAvailableException

Die Benutzeroberfläche für das AutomationElement ist nicht mehr vorhanden.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Name Eigenschaft zwischengespeichert und dann mithilfe der Cached Eigenschaft abgerufen werden kann.

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

Hinweise

Die Zugriffsoren für Benutzeroberflächenautomatisierung Eigenschaften werden als Eigenschaften der von Cachedder Struktur zurückgegebenen Struktur dargestellt. Sie müssen die Struktur nicht abrufen; Sie können direkt auf seine Mitglieder zugreifen, wie im folgenden Beispiel. Spezifische Informationen zu den verfügbaren Eigenschaften und deren Verwendung finden Sie unter AutomationElement.AutomationElementInformation.

Um den aktuellen Wert von Benutzeroberflächenautomatisierung Eigenschaften für dieses Element abzurufen, verwenden Sie die Current Eigenschaft.

Gilt für

Siehe auch