Delen via

Lokalisatiekenmerken en opmerkingen

  • Artikel

WpF-lokalisatieopmerkingen (Windows Presentation Foundation) zijn eigenschappen, binnen de broncode van XAML, die door ontwikkelaars wordt geleverd om regels en hints voor lokalisatie te bieden. WPF-lokalisatieopmerkingen bevatten twee sets informatie: lokalisatiekenmerken en opmerkingen over vrije lokalisatie. Lokalisatiekenmerken worden gebruikt door de WPF-lokalisatie-API om aan te geven welke resources moeten worden gelokaliseerd. Opmerkingen in vrije vorm zijn informatie die de auteur van de toepassing wil opnemen.

Lokalisatieopmerkingen toevoegen

Als auteurs van markeringstoepassingen vereisten hebben voor specifieke elementen in XAML, zoals beperkingen voor tekstlengte, lettertypefamilie of tekengrootte, kunnen ze deze informatie overbrengen naar lokalisaties met opmerkingen in de XAML-code. Het proces voor het toevoegen van opmerkingen aan broncode is als volgt:

  1. Toepassingsontwikkelaar voegt lokalisatieopmerkingen toe aan de broncode van XAML.

  2. Tijdens het buildproces kunt u opgeven in het PROJ-bestand of u de vrije lokalisatieopmerkingen in de assembly wilt achterlaten, een deel van de opmerkingen wilt verwijderen of alle opmerkingen wilt verwijderen. De uitgestripte opmerkingen worden in een afzonderlijk bestand geplaatst. U geeft uw optie op met behulp van een LocalizationDirectivesToLocFile tag, bijvoorbeeld:

    <LocalizationDirectivesToLocFile> waarde</LocalizationDirectivesToLocFile>

  3. De waarden die kunnen worden toegewezen, zijn:

    • Geen - Zowel opmerkingen als kenmerken blijven binnen de assembly en er wordt geen afzonderlijk bestand gegenereerd.

    • CommentsOnly - Verwijdert alleen de opmerkingen van de assembly en plaatst deze in het afzonderlijke LocFile.

    • Alle - Verwijdert zowel de opmerkingen als de kenmerken van de assembly en plaatst ze beide in een afzonderlijk LocFile.

  4. Wanneer lokaliseerbare resources worden geëxtraheerd uit BAML, worden de lokalisatiekenmerken gerespecteerd door de BAML Localization-API.

  5. Lokalisatieopmerkingsbestanden, die alleen vrije opmerkingen bevatten, worden op een later tijdstip opgenomen in het lokalisatieproces.

In het volgende voorbeeld ziet u hoe u lokalisatieopmerkingen toevoegt aan een XAML-bestand.

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

In het vorige voorbeeld bevat de sectie Localization.Attributes de lokalisatiekenmerken en de sectie Localization.Comments de vrije opmerkingen. In de volgende tabellen worden de kenmerken en opmerkingen en hun betekenis voor de localizer weergegeven.

Lokalisatiekenmerken Betekenis
$Content (niet-aanpasbare leesbare tekst) De inhoud van het TextBlock-element kan niet worden gewijzigd. Localizers kunnen het woord 'Microsoft' niet wijzigen. De inhoud is zichtbaar (leesbaar) voor de localizer. De categorie van de inhoud is tekst.
FontFamily (niet te wijzigen leesbaar) De eigenschap lettertypefamilie van het TextBlock-element kan niet worden gewijzigd, maar is zichtbaar voor de lokalisatiefunctie.
Vrije vorm opmerkingen lokaliseren Betekenis
$Content (handelsmerk) De auteur van de toepassing vertelt de localizer dat de inhoud in het TextBlock-element een handelsmerk is.
FontSize (tekengrootte handelsmerk) De auteur van de toepassing geeft aan dat de eigenschap tekengrootte moet voldoen aan de standaard handelsmerkgrootte.

Lokaliseerbaarheidskenmerken

De informatie in Localization.Attributes bevat een lijst met paren: de naam van de doelwaarde en de bijbehorende lokalisatiewaarden. De doelnaam kan een eigenschapsnaam of de speciale $Content naam zijn. Als het een eigenschapsnaam is, is de doelwaarde de waarde van de eigenschap. Als het $Content is, is de doelwaarde de inhoud van het element.

Er zijn drie typen kenmerken:

  • Categorie. Hiermee geeft u op of een waarde moet worden gewijzigd vanuit een localizer-hulpprogramma. Zie Category.

  • leesbaarheid. Hiermee geeft u op of een localizer-hulpprogramma een waarde moet lezen (en weergeven). Zie Readability.

  • wijzigbaarheid. Hiermee geeft u op of met een localizer-hulpprogramma een waarde kan worden gewijzigd. Zie Modifiability.

Deze kenmerken kunnen worden opgegeven in elke volgorde die wordt gescheiden door een spatie. Als er dubbele kenmerken worden opgegeven, overschrijft het laatste kenmerk voormalige kenmerken. Bijvoorbeeld, de code Localization.Attributes = "Unmodifiable Modifiable" stelt Wijzigbaarheid in op Modifiable omdat dit de laatste waarde is.

Wijzigbaarheid en leesbaarheid zijn duidelijk. Het kenmerk Categorie biedt vooraf gedefinieerde categorieën die de lokalisatiefunctie helpen bij het vertalen van tekst. Categorieën, zoals Tekst, Label en Titel, geven de localizer informatie over het vertalen van de tekst. Er zijn ook speciale categorieën: Geen, Overnemen, Negeren en NeverLocalize.

In de volgende tabel ziet u de betekenis van de speciale categorieën.

Categorie Betekenis
Geen De doelwaarde heeft geen gedefinieerde categorie.
Erven De doelwaarde erft zijn categorie van de bovenliggende categorie.
Negeren De doelwaarde wordt genegeerd in het lokalisatieproces. Negeren is alleen van invloed op de huidige waarde. Dit heeft geen invloed op onderliggende knooppunten.
NeverLocalize De huidige waarde kan niet worden gelokaliseerd. Deze categorie wordt overgenomen door de kindelementen.

Lokalisatieopmerkingen

Localization.Comments bevat vrije tekenreeksen met betrekking tot de doelwaarde. Ontwikkelaars van toepassingen kunnen informatie toevoegen om localizers hints te geven over hoe de tekst van de toepassingen moet worden vertaald. Het formaat van de opmerkingen kan iedere tekenreeks zijn die wordt omgeven door "()". Gebruik '\' om tekens te ontsnappen.

Zie ook