FrameworkElement.Language Properti

  • Referensi

Definisi

Ruang nama:
Windows.UI.Xaml
Edit

Mendapatkan atau mengatur informasi bahasa pelokalan/globalisasi yang berlaku untuk FrameworkElement, dan juga untuk semua elemen anak dari FrameworkElement saat ini dalam representasi objek dan di UI.

public:
 property Platform::String ^ Language { Platform::String ^ get(); void set(Platform::String ^ value); };
winrt::hstring Language();

void Language(winrt::hstring value);
public string Language { get; set; }
var string = frameworkElement.language;
frameworkElement.language = string;
Public Property Language As String
<frameworkElement Language="languageString" />

Nilai Properti

String

Platform::String

winrt::hstring

String yang menentukan bahasa dan budaya yang mengikuti standar Internet Engineering Task Force (IETF) BCP 47 . Misalnya, bahasa Inggris A.S. adalah "en-US".

Keterangan

Properti Bahasa ditujukan untuk mengatur pengaturan bahasa per elemen pada elemen yang dipilih di UI yang lebih besar. Alasan utama untuk melakukan ini adalah untuk memengaruhi properti dan pengaturan terkait teks, seperti apa fontFamily default atau fallback harus untuk presentasi teks.

Nilai default untuk properti ini adalah bahasa teratas dari daftar bahasa aplikasi, yang berasal dari daftar peringkat bahasa pilihan pengguna. Kami menyarankan agar Anda meninggalkan default untuk properti ini, karena akan memberikan pengalaman pengguna akhir terbaik dalam hal fallback font. Misalnya, jika aplikasi menampilkan konten Asia Timur dan pengguna telah menentukan bahasa Asia Timur di profil pengguna mereka, konten akan sebagian besar keandalan muncul di font Asia Timur yang diinginkan.

Properti Bahasa terutama relevan untuk subkelas FrameworkElement ini:

Kelas TextElement juga memiliki properti Bahasa , dan memiliki tujuan dan perilaku yang sama untuk subkelas TextElement seperti Jalankan.

Jika tidak secara khusus ditetapkan sebagai atribut, nilai default untuk Bahasa ditentukan oleh faktor lain yang lebih besar yang memengaruhi pengaturan globalisasi dan pelokalan untuk aplikasi Anda. Ini termasuk pengaturan sistem pengguna. Untuk informasi selengkapnya, lihat Meng-globalisasi aplikasi Anda.

Mengatur Bahasa pada elemen UI hanyalah bagian kecil dari apa yang mungkin Anda lakukan untuk menyiapkan aplikasi untuk pelokalan dan globalisasi. Misalnya, Anda biasanya perlu memberi nama atau memuat sumber daya seperti string dan gambar dan menyertakan sumber daya ini dalam paket aplikasi Anda. Anda juga perlu menerapkan nilai direktif x:Uid ke elemen apa pun yang harus menggunakan kualifikasi sumber daya untuk mendapatkan sumber daya khusus bahasa. Untuk informasi selengkapnya, lihat Meng-globalisasi aplikasi Anda.

Saat Anda mengatur Bahasa dalam markup, Anda harus mempertimbangkan untuk menggunakan file sumber daya RESW untuk menentukan string BCP 47, daripada mengodekan string secara permanen dalam markup. Tentukan nilai direktif x:Uid pada elemen tempat Anda ingin menentukan Bahasa sehingga sistem sumber daya dapat menargetkan elemen. Kemudian sediakan sumber daya string string BCP 47 yang cocok dengan nama folder sumber daya asal sumber daya. Anda mungkin sudah memiliki file RESW dalam proyek Anda yang menyediakan string UI konvensional yang dilokalkan. Untuk informasi selengkapnya, lihat Mulai Cepat: Menerjemahkan sumber daya UI.

FrameworkElement.Language dan xml:lang

XAML adalah bahasa yang didasarkan pada XML dan mengikuti aturan XML dasar. Ini termasuk mendukung konstruksi XML seperti atribut bahasa lang dari namespace XML bahasa XML. Anda dapat menentukan xml:lang pada elemen objek untuk subkelas FrameworkElement , dan diperlakukan sama seolah-olah itu adalah nilai Bahasa, karena menggunakan penanganan BCP 47 yang sama dari nilai atribut string. Anda juga dapat menentukan xml:lang pada elemen objek yang bukan subkelas FrameworkElement , meskipun biasanya tidak akan mengakibatkan perubahan perilaku apa pun pada elemen tersebut.

Bahasa sengaja menggunakan struktur pewarisan properti sehingga nilai untuk Bahasa yang diatur pada elemen akar akan menyebarkan nilai tersebut ke semua objek turunan di pohon visual yang juga merupakan FrameworkElement. Ini menyejajarkan perilaku xml:lang di XML dan XML DOM. Selain itu, Anda dapat menggunakan Bahasa pada durasi untuk membaca nilai xml:lang yang diatur dalam markup, selama elemen yang Anda baca adalah subkelas FrameworkElement yang memiliki properti Bahasa.

Namun, Anda tidak dapat menentukan atribut Bahasa dan xml:lang pada elemen objek yang sama, yang akan melempar kesalahan penguraian XAML.

Catatan migrasi

API ini mengambil string. Dalam API Microsoft Silverlight dan Windows Presentation Foundation (WPF) yang setara, jenis properti ini adalah objek pembantu yang membungkus string yang sama. Anda dapat mengimpor XAML dari proyek lain tanpa melihat perbedaan ini, karena bagaimana XAML mengurai string identik.

Berlaku untuk

Lihat juga