Sdílet prostřednictvím

Získání vlastností elementů automatizace uživatelského rozhraní

  • Článek

Poznámka:

Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy model UI Automation definované v System.Windows.Automation oboru názvů. Nejnovější informace o model UI Automation najdete v tématu Rozhraní API služby Windows Automation: model UI Automation.

Toto téma ukazuje, jak načíst vlastnosti elementu model UI Automation.

Získání aktuální hodnoty vlastnosti

  1. AutomationElement Získejte majetek, který chcete získat.

  2. Volání GetCurrentPropertyValuenebo načtení Current struktury vlastnosti a získání hodnoty z jednoho z jeho členů.

Získání hodnoty vlastnosti uložené v mezipaměti

  1. AutomationElement Získejte majetek, který chcete získat. Vlastnost musí být zadána v objektu CacheRequest.

  2. Volání GetCachedPropertyValuenebo načtení Cached struktury vlastnosti a získání hodnoty z jednoho z jeho členů.

Příklad

Následující příklad ukazuje různé způsoby, jak načíst aktuální vlastnosti objektu AutomationElement.

void PropertyCallsExample(AutomationElement elementList)
{
    // The following two calls are equivalent.
    string name = elementList.Current.Name;
    name = elementList.GetCurrentPropertyValue(AutomationElement.NameProperty) as string;

    // The following shows how to ignore the default property, which
    //  would probably be an empty string if the property is not supported.
    //  Passing "false" as the second parameter is equivalent to using the overload
    //  that does not have this parameter.
    object help = elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty, true);
    if (help == AutomationElement.NotSupported)
    {
        help = "No help available";
    }
    string helpText = (string)help;
}

Sub PropertyCallsExample(ByVal elementList As AutomationElement)
    ' The following two calls are equivalent.
    Dim name As String = elementList.Current.Name
    name = CStr(elementList.GetCurrentPropertyValue(AutomationElement.NameProperty))

    ' The following shows how to ignore the default property, which 
    '  would probably be an empty string if the property is not supported.
    '  Passing "false" as the second parameter is equivalent to using the overload
    '  that does not have this parameter.
    Dim help As Object = elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty, True)
    If help Is AutomationElement.NotSupported Then
        help = "No help available"
    End If
    Dim helpText As String = CStr(help)

End Sub

Viz také