AutomationPeer.GetNameCore Metode

Definisi

Ruang nama:

Microsoft.UI.Xaml.Automation.Peers

Menyediakan perilaku serekan saat klien Microsoft UI Automation memanggil GetName atau API klien Microsoft UI Automation yang setara.

protected:
 virtual Platform::String ^ GetNameCore() = GetNameCore;

winrt::hstring GetNameCore();

protected virtual string GetNameCore();

function getNameCore()

Protected Overridable Function GetNameCore () As String

Mengembalikan

String

Platform::String

winrt::hstring

Nama 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 Automasi UI Microsoft LabeledBy, nilai Nama elemen pelabelan digunakan sebagai Nama.

FrameworkElementAutomationPeer juga memperkenalkan perilaku melalui metode GetPlainText internal yang dapat diambil alih oleh kelas serekan 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 memberikan 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 serekan dapat diubah dengan mengambil kelas serekan baru dari serekan yang ada, menimpa 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

• GetName()
• Rekan otomatisasi kustom