Bagikan melalui

Atribut dan Komentar Pelokalan

Komentar pelokalan Windows Presentation Foundation (WPF) adalah properti, di dalam kode sumber XAML, yang disediakan oleh pengembang guna memberikan aturan dan petunjuk 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 Lokal

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> nilai</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 assembly dan memindahkannya ke LocFile terpisah.

    • Semua - Menghapus baik komentar maupun atribut dari assembly dan menempatkannya keduanya ke dalam LocFile terpisah.

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

  5. File komentar lokal, yang hanya berisi komentar bentuk bebas, dimasukkan dalam proses pelokalan pada tahap selanjutnya.

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 (Tidak Dapat Diubah dan Dapat Dibaca) Properti keluarga font dari elemen TextBlock tidak dapat diubah tetapi terlihat oleh localizer.
Komentar bebas dalam 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 Lokalisasi

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.

  • Kemampuan Dimodifikasi. 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 modifiabilitas 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.
Mengabaikan Nilai yang ditargetkan diabaikan dalam proses pelokalan. Abaikan hanya memengaruhi nilai saat ini. Ini tidak akan mempengaruhi node anak.
NeverLocalize Nilai saat ini tidak dapat dilokalkan. Kategori ini diwariskan kepada anak 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.

Lihat juga

  • Last updated on