Bagikan melalui

AutomationProperties.Name Properti Terlampir

  • Referensi

Definisi

Ruang nama:
Microsoft.UI.Xaml.Automation
Edit

Mendapatkan atau mengatur nama Automasi UI dari elemen .

see GetName, and SetName
see GetName, and SetName
see GetName, and SetName

Keterangan

Properti Name harus sama dengan teks label di layar. Misalnya, Name harus "Telusuri" untuk elemen tombol dengan label "Telusuri". Properti Name tidak boleh menyertakan karakter mnemonik untuk kunci akses (yaitu, "&"), yang digaris bawahi dalam presentasi teks UI. Selain itu Name , properti tidak boleh menjadi versi label di layar yang diperluas atau dimodifikasi karena inkonsistensi antara nama dan label dapat menyebabkan kebingungan di antara aplikasi klien dan pengguna.

Saat teks label yang sesuai tidak terlihat di layar, atau ketika digantikan oleh grafik, teks alternatif harus dipilih. Teks alternatif harus ringkas, intuitif, dan dilokalkan ke bahasa UI aplikasi, atau ke bahasa UI default sistem operasi. Teks alternatif tidak boleh menjadi deskripsi detail detail visual, tetapi deskripsi ringkas tentang fungsi atau fitur UI seolah-olah diberi label dengan teks sederhana. Misalnya, tombol menu Mulai Windows diberi nama "Mulai" (tombol) alih-alih "Logo Windows pada grafik bola bulat biru" (tombol). Untuk informasi selengkapnya, lihat Membuat Setara Teks untuk Gambar.

Saat label UI menggunakan grafik teks (misalnya, menggunakan ">>" untuk tombol yang menambahkan item dari kiri ke kanan), Name properti harus ditimpa oleh alternatif teks yang sesuai (misalnya, "Tambahkan"). Namun praktik penggunaan grafik teks sebagai label UI tidak disarankan karena masalah pelokalan dan aksesibilitas.

Name Properti tidak boleh menyertakan peran kontrol atau informasi jenis, seperti "tombol" atau "daftar"; jika tidak, itu akan bertentangan dengan teks dari properti LocalizedControlType ketika kedua properti ini ditambahkan (banyak teknologi bantuan yang ada melakukan ini).

Properti Name tidak dapat digunakan sebagai pengidentifikasi unik di antara saudara kandung. Namun, selama konsisten dengan presentasi UI, nilai yang sama Name dapat didukung di antara serekan. Untuk otomatisasi pengujian, klien harus mempertimbangkan untuk menggunakan properti AutomationId atau RuntimeId .

Kontrol teks tidak selalu harus memiliki Name properti yang identik dengan teks yang ditampilkan dalam kontrol, selama pola Teks juga didukung.

Dari berbagai properti terlampir, mungkin yang paling penting adalah Name. Ini karena properti ini adalah Name properti yang paling sering diakses dan dilaporkan oleh teknologi bantuan ketika pengguna berinteraksi dengan aplikasi dalam skenario aksesibilitas. berfungsi Name sebagai pengidentifikasi yang dapat dibaca manusia untuk elemen UI.

Berbagai elemen UI memiliki penerusan serekan yang dapat memberikan nilai default Name berdasarkan properti elemen lainnya. Misalnya, penerusan serekan untuk kelas Tombol akan meneruskan ToString evaluasi konten Tombol dan menggunakan string ini sebagai default Name. Untuk mengambil alih default tersebut, atau memberikan Name nilai untuk setiap kasus elemen UI di mana tidak ada Microsoft UI Automation Name yang tersedia, atur properti terlampir pada elemen tersebut Name di XAML. Untuk informasi selengkapnya tentang mengapa Microsoft UI Automation Name penting, lihat Informasi aksesibilitas dasar. Untuk informasi selengkapnya tentang cara menguji apakah elemen sudah memiliki peer-supplied Name yang berguna, lihat Pengujian aksesibilitas.

Untuk alasan pelokalan, Anda harus menghindari nilai string yang dikodekan secara permanen untuk Name di XAML. Jika Anda mengatur direktif x:Uid pada elemen , maka Anda dapat menggunakan sumber daya RESW untuk menargetkan properti dan memberikan nilai yang berbeda untuk pelokalan. Untuk properti terlampir, formulir pengidentifikasi sumber daya memerlukan kualifikasi penuh properti terlampir dalam formulir XAML, termasuk namespace layanannya dan menggunakan: awalan. Misalnya, untuk menargetkan AutomationProperties.Name nilai properti terlampir pada sumber daya yang memiliki nilai direktif x:Uid "sendButton", Name nilai item data dalam sumber daya RESW adalah sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name

Berlaku untuk

Lihat juga