Atributos y comentarios sobre localización

Los comentarios de localización de Windows Presentation Foundation (WPF) son propiedades, dentro del código fuente de XAML, suministradas por los desarrolladores para proporcionar reglas y sugerencias para la localización. Los comentarios de localización de Windows Presentation Foundation (WPF) contienen dos conjuntos de información: los atributos de localización y los comentarios sobre localización de forma libre. La API de localización de WPF utiliza los atributos de localización para indicar qué recursos se deben localizar. Los comentarios de forma libre son cualquier información que el autor de la aplicación desea incluir.

Este tema contiene las secciones siguientes.

• Comentarios de localización
• Comentarios de localización
• Temas relacionados

Comentarios de localización

Si los autores de una aplicación de marcado tienen requisitos para elementos concretos de XAML, tales como restricciones en la longitud del texto, familia de fuentes o tamaño de fuente, pueden transmitir esta información a los localizadores mediante comentarios en el código XAML. El proceso para agregar comentarios al código fuente es el siguiente:

1. El programador de la aplicación agrega los comentarios de localización al código fuente XAML.

2. Durante el proceso de compilación, puede especificar en el archivo .proj si conservar los comentarios de localización de forma libre en el ensamblado, quitar parte de ellos o quitarlos todos. Los comentarios quitados se colocan en un archivo independiente. La opción se especifica mediante una etiqueta LocalizationDirectivesToLocFile, por ejemplo:

   <LocalizationDirectivesToLocFile>valor</LocalizationDirectivesToLocFile>

3. Los valores que se pueden asignar son:

   • None: se conservan tanto los comentarios como los atributos en el ensamblado y no se genera ningún archivo independiente.

   • CommentsOnly: únicamente se quitan los comentarios del ensamblado y se colocan en el archivo LocFile independiente.

   • All: se quitan los comentarios y los atributos del ensamblado y se colocan en el archivo LocFile independiente.

4. Cuando los recursos localizables se extraen del BAML, la API de localización de BAML respeta los atributos de localización.

5. Los archivos de comentarios de localización, que únicamente contienen comentarios de forma libre, se incorporan al proceso de localización en un momento posterior.

En el ejemplo siguiente se muestra cómo agregar comentarios de localización a un archivo 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>

En el ejemplo anterior, la sección Localization.Attributes contiene los atributos de localización, y la sección Localization.Comments, los comentarios de forma libre. En las tablas siguientes se muestran los atributos y comentarios, así como su significado para el localizador.

Atributos de localización	Significado
$Content (Unmodifiable Readable Text)	No se puede modificar el contenido del elemento TextBlock. Los localizadores no pueden cambiar la palabra "Microsoft". El contenido está visible (Readable) para el localizador. La categoría del contenido es Text (texto).
FontFamily (Unmodifiable Readable)	No se puede cambiar la propiedad de familia de fuentes del elemento TextBlock, pero está visible para el localizador.

Comentarios de localización de forma libre	Significado
$Content (Trademark)	El autor de la aplicación indica al localizador que el contenido del elemento TextBlock es una marca comercial.
FontSize (Trademark font size)	El autor de la aplicación indica que la propiedad de tamaño de fuente debe respetar el tamaño estándar de la marca comercial.

Atributos de localización

La información de Localization.Attributes contiene una lista de parejas: el nombre del valor de destino y los valores de localización asociados. El nombre de destino puede ser un nombre de propiedad o el nombre $Content especial. Si es un nombre de propiedad, el valor de destino es el valor de la propiedad. Si es $Content, el valor de destino es el contenido del elemento.

Hay tres tipos de atributos:

• Category. Especifica si un valor debe ser modificable en la herramienta de localización. Vea Category.

• Readability. Especifica si la herramienta de localización podrá leer (y mostrar) un valor. Vea Readability.

• Modifiability. Especifica si la herramienta de localización permite modificar un valor. Vea Modifiability.

Estos atributos se pueden especificar en cualquier orden delimitados por espacios. Si se especifican atributos duplicados, el último invalidará los anteriores. Por ejemplo, Localization.Attributes = "Unmodifiable Modifiable" establece la categoría Modifiability en Modifiable porque es el último valor.

Los atributos Modifiability y Readability no precisan explicación. El atributo Category proporciona categorías predefinidas que ayudan al localizador al traducir el texto. Las categorías, tales como Text, Label o Title ofrecen al localizador información sobre cómo traducir el texto. Hay también categorías especiales: None, Inherit, Ignore y NeverLocalize.

En la tabla siguiente se muestra el significado de las categorías especiales.

Categoría	Significado
None	El valor de destino no tiene ninguna categoría definida.
Inherit	El valor de destino hereda su categoría de su elemento primario.
Ignore	El valor de destino se omite en el proceso de localización. Ignore afecta únicamente al valor actual. No afecta a los nodos secundarios.
NeverLocalize	El valor actual no se puede localizar. Los elementos secundarios de un elemento heredan esta categoría.

Comentarios de localización

Localization.Comments contiene cadenas de forma libre acerca del valor de destino. Los programadores de aplicaciones pueden agregar información para proporcionar sugerencias a los localizadores sobre cómo se debe traducir el texto de las aplicaciones. El formato de los comentarios puede ser cualquier cadena contenida entre "()". Utilice '\' para especificar caracteres de escape.

Vea también

Tareas

Cómo: Usar el diseño automático para crear un botón

Cómo: Usar una cuadrícula para el diseño automático

Conceptos

Globalización de WPF

Cómo: Localizar una aplicación