Attributi e commenti di localizzazione

  • Articolo

I commenti di localizzazione di Windows Presentation Foundation (WPF) sono proprietà, all'interno del codice sorgente XAML, fornite dagli sviluppatori per fornire regole e suggerimenti per la localizzazione. I commenti di localizzazione WPF contengono due set di informazioni: attributi di localizzazione localizzabilità e commenti di localizzazione in formato libero. Gli attributi di localizzazione vengono usati dall'API di localizzazione WPF per indicare quali risorse devono essere localizzate. I commenti in formato libero comprendono tutte le informazioni che l'autore dell'applicazione vuole includere.

Aggiungere commenti di localizzazione

Se gli autori di applicazioni di markup hanno requisiti per elementi specifici in XAML, ad esempio vincoli sulla lunghezza del testo, sulla famiglia di caratteri o sulle dimensioni del carattere, possono trasmettere queste informazioni ai localizzatori con commenti nel codice XAML. Il processo di aggiunta di commenti al codice sorgente è il seguente:

  1. Lo sviluppatore di applicazioni aggiunge commenti di localizzazione al codice sorgente XAML.

  2. Durante il processo di compilazione, nel file con estensione proj è possibile specificare se mantenere i commenti di localizzazione in formato libero nell'assembly, se rimuoverne una parte o se rimuoverli tutti. I commenti rimossi vengono inseriti in un file separato. Per indicare la scelta si usa un tag LocalizationDirectivesToLocFile, ad esempio:

    <LocalizationDirectivesToLocFile>value</LocalizationDirectivesToLocFile>

  3. I valori che è possibile assegnare sono:

    • None: sia i commenti che gli attributi rimangono nell'assembly e non viene generato alcun file separato.

    • CommentsOnly: dall'assembly vengono rimossi solo i commenti, che vengono inseriti nel LocFile separato.

    • All: dall'assembly vengono rimossi sia i commenti che gli attributi, che vengono inseriti entrambi in un LocFile separato.

  4. Quando le risorse localizzabili vengono estratte da BAML, gli attributi di localizzazione vengono rispettati dall'API di localizzazione BAML.

  5. I file dei commenti di localizzazione, nei quali sono contenuti solo commenti in formato libero, vengono incorporati al processo di localizzazione in un secondo momento.

L'esempio seguente illustra come aggiungere commenti di localizzazione a un 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>

Nella sezione Localization.Attributes dell'esempio precedente sono disponibili gli attributi di localizzazione, mentre nella sezione Localization.Comments sono disponibili i commenti in formato libero. La tabella seguente illustra gli attributi, i commenti e il relativo significato per il localizzatore.

Attributi di localizzazione Significato
$Content (testo leggibile non modificabile) Il contenuto dell'elemento TextBlock non può essere modificato. I localizzatori non possono modificare la parola "Microsoft". Il contenuto è visibile (leggibile) per il localizzatore. La categoria del contenuto è testo.
FontFamily (leggibile non modificabile) La proprietà della famiglia di caratteri dell'elemento TextBlock non può essere modificata, ma è visibile per il localizzatore.
Commenti di localizzazione in formato libero Significato
$Content (marchio) L'autore dell'applicazione indica al localizzatore che il contenuto dell'elemento TextBlock è un marchio.
FontSize (dimensioni del carattere del marchio) L'autore dell'applicazione indica che la proprietà delle dimensioni del carattere deve rispettare la dimensione standard del marchio.

Attributi di localizzabilità

Le informazioni disponibili nella sezione Localization.Attributes contengono un elenco di coppie: il nome del valore di destinazione e i valori di localizzabilità associati. Il nome di destinazione può essere un nome di proprietà o il nome speciale $Content. Se si tratta di un nome di proprietà, il valore di destinazione è il valore della proprietà. Se si tratta di $Content, il valore di destinazione è il contenuto dell'elemento.

Sono disponibili tre tipi di attributi:

  • Categoria. Specifica se un valore può essere modificato con uno strumento del localizzatore. Vedere Category.

  • Leggibilità. Specifica se uno strumento del localizzatore deve essere in grado di leggere (e visualizzare) un valore. Vedere Readability.

  • Modifiability. Specifica se uno strumento del localizzatore consente la modifica di un valore. Vedere Modifiability.

Questi attributi possono essere specificati in qualsiasi ordine e devono essere delimitati da uno spazio. Nel caso in cui vengano specificati attributi duplicati, l'ultimo sostituisce i precedenti. Ad esempio, Localization.Attributes = "Unmodifiable Modifiable" imposta Modifiability su Modifiable poiché questo è l'ultimo valore.

Gli attributi Modifiability e Readability sono di facile comprensione. L'attributo Category fornisce categorie predefinite che supportano il localizzatore nella traduzione del testo. Categorie quali Text, Label e Title offrono al localizzatore informazioni sulla modalità di traduzione del testo. Sono disponibili anche categorie speciali: None, Inherit, Ignore e NeverLocalize.

La tabella seguente illustra il significato delle categorie speciali.

Categoria Significato
None Per il valore di destinazione non è definita alcuna categoria.
Inherit Il valore di destinazione eredita la categoria dall'elemento padre.
Ignora Il valore di destinazione viene ignorato nel processo di localizzazione. Questa categoria influisce solo sul valore corrente e non sui nodi figlio.
NeverLocalize Il valore corrente non può essere localizzato. Questa categoria viene ereditata dagli elementi figlio di un elemento.

Commenti di localizzazione

La sezione Localization.Comments contiene le stringhe in formato libero relative al valore di destinazione. Gli sviluppatori dell'applicazione possono aggiungere informazioni per offrire ai localizzatori suggerimenti sulla modalità di traduzione del testo delle applicazioni. Il formato dei commenti può essere una qualsiasi stringa racchiusa tra "()". Usare '\' per eseguire l'escape dei caratteri.

Vedi anche