Megosztás a következőn keresztül:

Honosítási attribútumok és megjegyzések

A Windows Presentation Foundation (WPF) honosítási megjegyzései az XAML-forráskódon belüli tulajdonságok, amelyeket a fejlesztők a honosítás szabályainak és tippjeinek megadásához biztosítanak. A WPF honosítási megjegyzései két információkészletet tartalmaznak: honosítási attribútumokat és szabad formátumú honosítási megjegyzéseket. A WPF Localization API honosítási attribútumokkal jelzi, hogy mely erőforrásokat kell honosítani. Az ingyenes formátumú megjegyzések olyan információk, amelyeket az alkalmazás szerzője fel szeretne venni.

Honosítási megjegyzések hozzáadása

Ha a korrektúraalkalmazás szerzőinek követelményei vannak az XAML adott elemeire, például a szöveghosszra, a betűcsaládra vagy a betűméretre vonatkozó korlátozásokra, ezeket az információkat továbbíthatják a honosítóknak az XAML-kód megjegyzéseivel. A megjegyzések forráskódhoz való hozzáadásának folyamata a következő:

  1. Az alkalmazásfejlesztő honosítási megjegyzéseket ad hozzá az XAML-forráskódhoz.

  2. A buildelési folyamat során megadhatja a .proj fájlban, hogy a szabad formátumú honosítási megjegyzéseket meghagyja-e a szerelvényben, eltávolítja-e a megjegyzések egy részét, vagy eltávolítja-e az összes megjegyzést. A levágott megjegyzések külön fájlba kerülnek. A lehetőséget egy LocalizationDirectivesToLocFile címkével adhatja meg, például:

    <LocalizationDirectivesToLocFile> érték</LocalizationDirectivesToLocFile>

  3. A hozzárendelhető értékek a következők:

    • Nincs – A megjegyzések és az attribútumok mind a szerelvényen belül maradnak, és nem generálódik külön fájl.

    • CommentsOnly – Csak a megjegyzéseket távolítja el a szerelvényből, és a külön LocFile-ban helyezi el őket.

    • Minden – Eltávolítja a megjegyzéseket és az attribútumokat az összeállításból, és külön LocFile-fájlba helyezi őket.

  4. A honosítható erőforrások BAML-ből való kinyerésekor a honosítási attribútumokat a BAML Honosítási API tiszteletben tartja.

  5. A honosítási megjegyzésfájlok, amelyek csak szabad formátumú megjegyzéseket tartalmaznak, később bekerülnek a honosítási folyamatba.

Az alábbi példa bemutatja, hogyan adhat hozzá honosítási megjegyzéseket egy XAML-fájlhoz.

<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>

Az előző mintában a Localization.Attributes szakasz tartalmazza a honosítási attribútumokat és a Localization.Comments szakaszt a szabad formátumú megjegyzésekhez. Az alábbi táblázatok az attribútumokat és megjegyzéseket, valamint azok jelentését mutatják be a honosító számára.

Honosítási attribútumok Értelmezés
$Content (nem módosítható olvasható szöveg) A TextBlock elem tartalma nem módosítható. A honosítók nem módosíthatják a "Microsoft" szót. A tartalom látható (olvasható) a honosító számára. A tartalom kategóriája szöveg.
FontFamily (olvasható, nem módosítható) A TextBlock elem betűcsalád tulajdonsága nem módosítható, de látható a honosító számára.
Lokalizációs szabad formátumú megjegyzések Értelmezés
$Content (védjegy) Az alkalmazás szerzője közli a honosítóval, hogy a TextBlock elem tartalma védjegy.
FontSize (Védjegy betűmérete) Az alkalmazás szerzője azt jelzi, hogy a betűméret tulajdonságnak a szabványos védjegyméretet kell követnie.

Honossági attribútumok

A Localization.Attributes információi párok listáját tartalmazzák: a megcélzott érték nevét és a hozzá tartozó lokalizálhatósági értékeket. A célnév lehet tulajdonságnév vagy speciális $Content név. Ha ez egy tulajdonságnév, a célérték a tulajdonság értéke. Ha $Content, a célérték az elem tartalma.

Az attribútumoknak három típusa van:

  • Kategória. Ez azt határozza meg, hogy egy érték módosítható legyen-e egy honosító eszközről. Lásd a(z) Category.

  • olvashatóság. Ez azt határozza meg, hogy a honosító eszköznek be kell-e olvasnia (és megjelenítenie) egy értéket. Lásd a(z) Readability.

  • Módosíthatóság. Ez azt határozza meg, hogy egy honosító eszköz lehetővé teszi-e egy érték módosítását. Lásd a(z) Modifiability.

Ezek az attribútumok tetszőleges, szóközzel tagolt sorrendben adhatók meg. Ismétlődő attribútumok megadása esetén az utolsó attribútum felülbírálja a korábbiakat. A "Localization.Attributes = 'Unmodifiable Modifiable'" például a módosíthatóságot 'Módosítható'-ra állítja be, mert ez az utolsó érték.

A módosíthatóság és az olvashatóság magától értetődő. A Kategória attribútum előre definiált kategóriákat biztosít, amelyek segítenek a honosítónak a szöveg fordítása során. A kategóriák, például a Szöveg, a Címke és a Cím információt adnak a honosítónak a szöveg fordításáról. Vannak speciális kategóriák is: None, Inherit, Ignore és NeverLocalize.

Az alábbi táblázat a speciális kategóriák jelentését mutatja be.

Kategória Értelmezés
Egyik sem A megcélzott értéknek nincs definiált kategóriája.
Örököl A megcélzott érték a szülőtől örökli a kategóriáját.
Hagyd figyelmen kívül A honosítási folyamat figyelmen kívül hagyja a megcélzott értéket. A figyelmen kívül hagyás csak az aktuális értéket érinti. Ez nem érinti a gyermekcsomópontokat.
NeverLocalize Az aktuális érték nem honosítható. Ezt a kategóriát egy elem gyermekei öröklik.

Honosítási megjegyzések

A Localization.Comments a megcélzott értékre vonatkozó szabad formátumú sztringeket tartalmaz. Az alkalmazásfejlesztők információkat adhatnak a honosítóknak arról, hogyan kell lefordítani az alkalmazás szövegét. A megjegyzések formátuma bármilyen sztring lehet, amelyet "()" vesz körül. Használja a '\' jelet a karakterek elkerülésére.

Lásd még

  • Last updated on