AutomationPeer.GetName Metode

Definisi

Ruang nama:

Windows.UI.Xaml.Automation.Peers

Mendapatkan teks yang menjelaskan elemen yang terkait dengan peer otomatisasi ini. Nilai Nama Otomatisasi UI Microsoft adalah pengidentifikasi utama yang digunakan oleh sebagian besar teknologi bantuan saat mewakili UI aplikasi Anda dengan berinteraksi dengan kerangka kerja Microsoft UI Automation.

public:
 virtual Platform::String ^ GetName() = GetName;

winrt::hstring GetName();

public string GetName();

function getName()

Public Function GetName () As String

Mengembalikan

String

Platform::String

winrt::hstring

Nama elemen yang merupakan pemilik serekan, seperti yang digunakan oleh teknologi bantuan dan klien Microsoft UI Automation lainnya.

Keterangan

FrameworkElementAutomationPeer memperkenalkan perilaku ke GetName dengan menyediakan implementasi GetNameCore menengah. Jika elemen memiliki nilai untuk properti Automation UI Microsoft LabeledBy, nilai Nama elemen pelabelan digunakan sebagai Nama.

FrameworkElementAutomationPeer juga memperkenalkan perilaku melalui metode GetPlainText internal yang dapat diambil alih oleh kelas peer default lainnya untuk mengakses model konten kontrol tersebut dan mengembalikan default yang berguna untuk Nama. Misalnya, kelas turunan ContentControl apa pun akan menggunakan representasi string dari nilai Kontennya sebagai Nama default. Ini diaktifkan karena secara internal ContentControl mengimplementasikan GetPlainText dan menerapkan perilaku tersebut ke semua kelas turunan ContentControl . Ini adalah cara Anda mendapatkan default Nama yang berguna dari nilai string Tombol, misalnya.

Serekan spesifik lainnya juga mungkin memiliki implementasi GetNameCore menengah yang menyediakan cara yang berguna untuk kontrol Windows Runtime tertentu untuk menyediakan nilai bawaan untuk Nama. Sumber nilai-nilai ini berasal dari properti UI lain yang biasanya diatur dalam XAML atau sebagai kode pengguna aplikasi. Misalnya, TextBoxAutomationPeer menerapkan perilaku yang menggunakan nilai properti Teks dari TextBox pemilik sebagai Nama default. Dari perspektif kode pengguna, perilaku default dapat ditimpa dengan menerapkan nilai AutomationProperties.Name yang berbeda. Dari perspektif peer implementer / provider, perilaku default peer dapat diubah dengan mendapatkan kelas peer baru dari peer yang ada, mengambil alih GetNameCore, dan memberinya implementasi baru yang tidak akan memanggil implementasi dasar dalam setidaknya beberapa kasus.

Untuk mempelajari selengkapnya tentang kemungkinan perilaku default kelas serekan tertentu untuk kontrol Windows Runtime default, lihat topik referensi untuk kelas serekan tertentu tersebut dan cari catatan implementasi di bagian Keterangan.

Lihat juga

• Rekan otomatisasi kustom