Share via

Atribut dan Komentar Pelokalan

  • Artikel

Komentar pelokalan Windows Presentation Foundation (WPF) adalah properti, di dalam kode sumber XAML, yang disediakan oleh pengembang untuk memberikan aturan dan petunjuk untuk pelokalan. Komentar pelokalan WPF berisi dua set informasi: atribut pelokalan dan komentar pelokalan bentuk bebas. Atribut pelokalan digunakan oleh API Pelokalan WPF untuk menunjukkan sumber daya mana yang akan dilokalkan. Komentar bentuk bebas adalah informasi apa pun yang ingin disertakan oleh penulis aplikasi.

Tambahkan Komentar Pelokalan

Jika penulis aplikasi markup memiliki persyaratan untuk elemen tertentu di XAML, seperti batasan panjang teks, keluarga font, atau ukuran font, mereka dapat menyampaikan informasi ini kepada pelokalan dengan komentar dalam kode XAML. Proses untuk menambahkan komentar ke kode sumber adalah sebagai berikut:

  1. Pengembang aplikasi menambahkan komentar pelokalan ke kode sumber XAML.

  2. Selama proses build, Anda dapat menentukan dalam file .proj apakah akan meninggalkan komentar pelokalan bentuk bebas di rakitan, menghapus sebagian komentar, atau menghapus semua komentar. Komentar yang dilucuti ditempatkan dalam file terpisah. Anda menentukan opsi Anda menggunakan LocalizationDirectivesToLocFile tag, misalnya:

    <LocalizationDirectivesToLocFile>value</LocalizationDirectivesToLocFile>

  3. Nilai yang dapat ditetapkan adalah:

    • None - Komentar dan atribut tetap berada di dalam assembly dan tidak ada file terpisah yang dihasilkan.

    • CommentsOnly - Hanya menghapus komentar dari perakitan dan menempatkannya di LocFile terpisah.

    • Semua - Strip komentar dan atribut dari assembly dan menempatkan mereka berdua di LocFile terpisah.

  4. Ketika sumber daya yang dapat dilokalkan diekstrak dari BAML, atribut lokalisasi dihormati oleh API Pelokalan BAML.

  5. File komentar pelokalan, hanya berisi komentar bentuk bebas, dimasukkan ke dalam proses pelokalan di lain waktu.

Contoh berikut menunjukkan cara menambahkan komentar pelokalan ke file XAML.

<TextBlock x:Id = "text01"

FontFamily = "Microsoft Sans Serif"

FontSize = "12"

Localization.Attributes = "$Content (Unmodifiable Readable Text)

FontFamily (Unmodifiable Readable)"

Localization.Comments = "$Content (Trademark)

FontSize (Trademark font size)" >

Microsoft

</TextBlock>

Di sampel sebelumnya, bagian Localization.Attributes berisi atribut pelokalan dan bagian Localization.Comments komentar bentuk bebas. Tabel berikut menunjukkan atribut dan komentar serta maknanya kepada localizer.

Atribut pelokalan Makna
$Content (Teks yang Dapat Dibaca Tidak Dapat Dimodifikasi) Konten elemen TextBlock tidak dapat dimodifikasi. Localizer tidak dapat mengubah kata "Microsoft". Konten terlihat (Dapat Dibaca) ke localizer. Kategori konten adalah teks.
FontFamily (Unmodifiable Readable) Properti keluarga font dari elemen TextBlock tidak dapat diubah tetapi terlihat oleh localizer.
Komentar bentuk bebas pelokalan Makna
$Content (Merek Dagang) Penulis aplikasi memberi tahu localizer bahwa konten dalam elemen TextBlock adalah merek dagang.
FontSize (Ukuran font merek dagang) Penulis aplikasi menunjukkan bahwa properti ukuran font harus mengikuti ukuran merek dagang standar.

Atribut Pelokalan

Informasi dalam Localization.Attributes berisi daftar pasangan: nama nilai yang ditargetkan dan nilai pelokalan terkait. Nama target dapat berupa nama properti atau nama $Content khusus. Jika ini adalah nama properti, nilai yang ditargetkan adalah nilai properti . Jika $Content, nilai target adalah konten elemen .

Ada tiga jenis atribut:

  • Kategori. Ini menentukan apakah nilai harus dapat dimodifikasi dari alat localizer. Lihat Category.

  • Keterbacaan. Ini menentukan apakah alat localizer harus membaca (dan menampilkan) nilai. Lihat Readability.

  • Modifikasi. Ini menentukan apakah alat localizer memungkinkan nilai untuk dimodifikasi. Lihat Modifiability.

Atribut ini dapat ditentukan dalam urutan apa pun yang dibatasi oleh spasi. Jika atribut duplikat ditentukan, atribut terakhir akan mengambil alih atribut sebelumnya. Misalnya, Localization.Attributes = "Unmodifiable Modifiable" mengatur Modifikasi ke Modifiable karena merupakan nilai terakhir.

Modifikasi dan Keterbacaan adalah penjelasan mandiri. Atribut Kategori menyediakan kategori yang telah ditentukan sebelumnya yang membantu localizer saat menerjemahkan teks. Kategori, seperti, Teks, Label, dan Judul memberikan informasi localizer tentang cara menerjemahkan teks. Ada juga kategori khusus: None, Inherit, Ignore, dan NeverLocalize.

Tabel berikut ini memperlihatkan arti kategori khusus.

Kategori Makna
Tidak ada Nilai yang ditargetkan tidak memiliki kategori yang ditentukan.
Mewarisi Nilai yang ditargetkan mewarisi kategorinya dari induknya.
Abaikan Nilai yang ditargetkan diabaikan dalam proses pelokalan. Abaikan hanya memengaruhi nilai saat ini. Ini tidak akan mempengaruhi simpul anak.
NeverLocalize Nilai saat ini tidak dapat dilokalkan. Kategori ini diwariskan oleh turunan dari sebuah elemen.

Komentar Pelokalan

Localization.Comments berisi string bentuk bebas mengenai nilai yang ditargetkan. Pengembang aplikasi dapat menambahkan informasi untuk memberikan petunjuk pelokalan tentang bagaimana teks aplikasi harus diterjemahkan. Format komentar dapat berupa string apa pun yang dikelilingi oleh "()". Gunakan '\' untuk meloloskan karakter.

Baca juga