AutomationElement.GetCurrentPropertyValue Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Automation
Bütünleştirilmiş Kod:
UIAutomationClient.dll

Belirtilen özelliğin geçerli değerini bir AutomationElement'den alır.

Aşırı Yüklemeler

GetCurrentPropertyValue(AutomationProperty)

Bu AutomationElementüzerinde belirtilen özelliğin değerini alır. Hedef kullanıcı arabirimi (UI) öğesi tarafından açıkça desteklenmeyen özellikler için özellik türü için uygun bir varsayılan değer döndürülür.
GetCurrentPropertyValue(AutomationProperty, Boolean)

Bu AutomationElementüzerinde belirtilen özelliğin değerini alır ve isteğe bağlı olarak herhangi bir varsayılan özelliği yok sayar.

Açıklamalar

yöntemi tarafından GetCurrentPropertyValue döndürülen değer çağrıldığında geçerli olur. Değer daha sonra kullanıcı arabirimi (UI) ile etkileşim kuran diğer uygulamalar tarafından değişebilir.

Bazı kullanıcı arabirimi biçimleri için bu yöntem işlemler arası performans ek yüküne neden olur. Uygulamalar özellikleri önbelleğe alıp kullanarak GetCachedPropertyValuebunları alarak ek yükü yoğunlaştırabilir.

GetCurrentPropertyValue(AutomationProperty)

Bu AutomationElementüzerinde belirtilen özelliğin değerini alır. Hedef kullanıcı arabirimi (UI) öğesi tarafından açıkça desteklenmeyen özellikler için özellik türü için uygun bir varsayılan değer döndürülür.

public:
 System::Object ^ GetCurrentPropertyValue(System::Windows::Automation::AutomationProperty ^ property);
public object GetCurrentPropertyValue (System.Windows.Automation.AutomationProperty property);
member this.GetCurrentPropertyValue : System.Windows.Automation.AutomationProperty -> obj
Public Function GetCurrentPropertyValue (property As AutomationProperty) As Object

Parametreler

property
AutomationProperty

Hangi özelliğin alınacağını belirten UI Otomasyonu özellik tanımlayıcısı.

Döndürülenler

Object

Belirtilen özelliğin değerini içeren bir nesne.

Özel durumlar

ElementNotAvailableException

için AutomationElement kullanıcı arabirimi artık yok.

Örnekler

Aşağıdaki örnek özelliğin geçerli değerini HelpText alır. öğesi sağlamazsa varsayılan değer döndürülür.

// elementList is an AutomationElement.
string helpString =
    elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty) as string;

' elementList is an AutomationElement.
Dim helpString As String = _
    CStr(elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty))

Açıklamalar

yöntemi tarafından GetCurrentPropertyValue döndürülen değer çağrıldığında geçerli olur. Bu değer daha sonra kullanıcı arabirimiyle etkileşim kuran diğer uygulamalar tarafından değişebilir.

Öğesinin UI Otomasyonu sağlayıcısı özelliği destekliyorsa, özelliğin değeri döndürülür. Aksi takdirde, UI Otomasyonu tarafından belirtilen varsayılan bir özellik döndürülür. Varsayılan özellikler hakkında bilgi için, gibi AcceleratorKeyPropertyözelliğinin AutomationElementözellik tanımlayıcısı alanlarına bakın.

Bazı kullanıcı arabirimi biçimleri için bu yöntem işlemler arası performans ek yüküne neden olur. Özellikleri önbelleğe alıp kullanarak GetCachedPropertyValuebunları alarak ek yükü yoğunlaştırma.

Şunlara uygulanır

GetCurrentPropertyValue(AutomationProperty, Boolean)

Bu AutomationElementüzerinde belirtilen özelliğin değerini alır ve isteğe bağlı olarak herhangi bir varsayılan özelliği yok sayar.

public:
 System::Object ^ GetCurrentPropertyValue(System::Windows::Automation::AutomationProperty ^ property, bool ignoreDefaultValue);
public object GetCurrentPropertyValue (System.Windows.Automation.AutomationProperty property, bool ignoreDefaultValue);
member this.GetCurrentPropertyValue : System.Windows.Automation.AutomationProperty * bool -> obj
Public Function GetCurrentPropertyValue (property As AutomationProperty, ignoreDefaultValue As Boolean) As Object

Parametreler

property
AutomationProperty

Hangi özelliğin alınacağını belirten UI Otomasyonu özellik tanımlayıcısı.

ignoreDefaultValue
Boolean

Belirtilen özellik destekleniyorsa varsayılan değerin yoksayılıp yoksayılmayacağını belirten bir değer.

Döndürülenler

Object

Belirtilen özelliğin değerini içeren bir nesne veya NotSupported öğesi bir değer sağlamazsa ve ignoreDefaultValue olur true.

Özel durumlar

ElementNotAvailableException

için AutomationElement kullanıcı arabirimi artık yok.

Örnekler

Aşağıdaki örnek özelliğin geçerli değerini HelpText alır, ancak öğenin kendisi özellik için bir değer sağlamazsa, NotSupported varsayılan değer yerine döndürülmesi gerektiğini belirtir.

// elementList is an AutomationElement.
object help = elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty, true);
if (help == AutomationElement.NotSupported)
{
    help = "No help available";
}
string helpText = (string)help;

' elementList is an AutomationElement.
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)

Açıklamalar

Geçiş, falseignoreDefaultValue çağrısıyla AutomationElement.GetCurrentPropertyValue(AutomationProperty)eşdeğerdir.

Öğesinin UI Otomasyonu sağlayıcısı özelliği destekliyorsa, özelliğin değeri döndürülür. Aksi takdirde, ise ignoreDefaultValuefalseUI Otomasyonu tarafından belirtilen varsayılan bir özellik döndürülür. Varsayılan özellikler hakkında bilgi için, gibi AcceleratorKeyPropertyözelliğinin AutomationElementözellik tanımlayıcısı alanlarına bakın.

yöntemi tarafından GetCurrentPropertyValue döndürülen değer çağrıldığında geçerli olur. Değer daha sonra kullanıcı arabirimi (UI) ile etkileşim kuran diğer uygulamalar tarafından değişebilir.

Bazı kullanıcı arabirimi biçimleri için bu yöntem işlemler arası performans ek yüküne neden olur. Uygulamalar özellikleri önbelleğe alıp kullanarak GetCachedPropertyValuebunları alarak ek yükü yoğunlaştırabilir.

Şunlara uygulanır