AutomationElement.GetCurrentPropertyValue Metode

Definisi

Ruang nama:

System.Windows.Automation

Rakitan:

UIAutomationClient.dll

Mengambil nilai saat ini dari properti yang ditentukan dari AutomationElement.

Overload

GetCurrentPropertyValue(AutomationProperty)	Mengambil nilai properti yang ditentukan pada ini AutomationElement. Nilai default yang sesuai untuk jenis properti dikembalikan untuk properti yang tidak didukung secara eksplisit oleh elemen antarmuka pengguna (UI) target.
GetCurrentPropertyValue(AutomationProperty, Boolean)	Mengambil nilai properti yang ditentukan pada ini AutomationElement, secara opsional mengabaikan properti default apa pun.

Keterangan

Nilai yang GetCurrentPropertyValue dikembalikan oleh metode adalah saat ini pada saat dipanggil. Nilai kemudian dapat berubah oleh aplikasi lain yang berinteraksi dengan antarmuka pengguna (UI).

Untuk beberapa bentuk UI, metode ini akan menimbulkan overhead performa lintas proses. Aplikasi dapat berkonsentrasi overhead dengan penembolokan properti dan kemudian mengambilnya dengan menggunakan GetCachedPropertyValue.

GetCurrentPropertyValue(AutomationProperty)

Mengambil nilai properti yang ditentukan pada ini AutomationElement. Nilai default yang sesuai untuk jenis properti dikembalikan untuk properti yang tidak didukung secara eksplisit oleh elemen antarmuka pengguna (UI) target.

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

Parameter

property

AutomationProperty

Pengidentifikasi properti Automation UI yang menentukan properti mana yang akan diambil.

Mengembalikan

Object

Objek yang berisi nilai properti yang ditentukan.

Pengecualian

ElementNotAvailableException

UI untuk AutomationElement tidak ada lagi.

Contoh

Contoh berikut mengambil nilai HelpText properti saat ini. Nilai default dikembalikan jika elemen tidak menyediakannya.

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

Keterangan

Nilai yang GetCurrentPropertyValue dikembalikan oleh metode adalah saat ini pada saat dipanggil. Nilai kemudian dapat berubah oleh aplikasi lain yang berinteraksi dengan UI.

Jika penyedia Automation UI untuk elemen itu sendiri mendukung properti , nilai properti dikembalikan. Jika tidak, properti default yang ditentukan oleh Automasi UI dikembalikan. Untuk informasi tentang properti default, lihat bidang pengidentifikasi properti , AutomationElementseperti AcceleratorKeyProperty.

Untuk beberapa bentuk UI, metode ini akan menimbulkan overhead performa lintas proses. Konsentrasi overhead dengan penembolokan properti dan kemudian mengambilnya dengan menggunakan GetCachedPropertyValue.

GetCurrentPropertyValue(AutomationProperty, Boolean)

Mengambil nilai properti yang ditentukan pada ini AutomationElement, secara opsional mengabaikan properti default apa pun.

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

Parameter

property

AutomationProperty

Pengidentifikasi properti Automation UI yang menentukan properti mana yang akan diambil.

ignoreDefaultValue

Boolean

Nilai yang menentukan apakah nilai default harus diabaikan jika properti yang ditentukan didukung.

Mengembalikan

Object

Objek yang berisi nilai properti yang ditentukan, atau NotSupported jika elemen tidak menyediakan nilai dan ignoreDefaultValue adalah true.

Pengecualian

ElementNotAvailableException

UI untuk AutomationElement tidak ada lagi.

Contoh

Contoh berikut mengambil nilai HelpText properti saat ini, tetapi menentukan bahwa jika elemen itu sendiri tidak memberikan nilai untuk properti , NotSupported akan dikembalikan alih-alih nilai default.

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

Keterangan

Passing false in ignoreDefaultValue setara dengan panggilan AutomationElement.GetCurrentPropertyValue(AutomationProperty).

Jika penyedia Automation UI untuk elemen itu sendiri mendukung properti , nilai properti dikembalikan. Jika tidak, jika ignoreDefaultValue adalah false, properti default yang ditentukan oleh Automasi UI dikembalikan. Untuk informasi tentang properti default, lihat bidang pengidentifikasi properti , AutomationElementseperti AcceleratorKeyProperty.

Nilai yang GetCurrentPropertyValue dikembalikan oleh metode adalah saat ini pada saat dipanggil. Nilai kemudian dapat berubah oleh aplikasi lain yang berinteraksi dengan antarmuka pengguna (UI).

Untuk beberapa bentuk UI, metode ini akan menimbulkan overhead performa lintas proses. Aplikasi dapat berkonsentrasi overhead dengan penembolokan properti dan kemudian mengambilnya dengan menggunakan GetCachedPropertyValue.