UI Otomasyon Öğesi Özelliklerini Alma

  • Makale

Not

Bu belgeler, ad alanında tanımlanan yönetilen UI Otomasyonu sınıflarını kullanmak isteyen .NET Framework geliştiricilerine System.Windows.Automation yöneliktir. UI Otomasyonu hakkında en son bilgiler için bkz. Windows Otomasyonu API'si: UI Otomasyonu.

Bu konuda, bir UI Otomasyonu öğesinin özelliklerini alma adımları gösterilmektedir.

Geçerli Özellik Değeri Alma

  1. AutomationElement Almak istediğiniz özelliğini edinin.

  2. öğesini çağırın GetCurrentPropertyValueCurrent veya özellik yapısını alın ve üyelerinden birinden değeri alın.

Önbelleğe Alınmış Özellik Değeri Alma

  1. AutomationElement Almak istediğiniz özelliğini edinin. özelliği içinde CacheRequestbelirtilmiş olmalıdır.

  2. öğesini çağırın GetCachedPropertyValueCached veya özellik yapısını alın ve üyelerinden birinden değeri alın.

Örnek

Aşağıdaki örnekte, bir AutomationElementöğesinin geçerli özelliklerini almanın çeşitli yolları gösterilmektedir.

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

Ayrıca bkz.