ApplicationLanguages Clase

Definición

Espacio de nombres:

Windows.Globalization

Especifica las preferencias relacionadas con el idioma que la aplicación puede usar y mantener.

public ref class ApplicationLanguages abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ApplicationLanguages final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class ApplicationLanguages

Public Class ApplicationLanguages

Herencia

Object Platform::Object IInspectable ApplicationLanguages

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Los idiomas a los que se hace referencia en esta clase se representan mediante etiquetas de idioma BCP-47. Cada uno de ellos es un identificador de idioma y no un nombre de configuración regional, aunque los dos estructuralmente pueden ser los mismos. Como etiqueta de idioma, "en-US" significa inglés americano (o el dialecto del inglés hablado en el Estados Unidos). No hace ninguna reclamación sobre la ubicación real de los hablantes (aunque muchos de ellos residen en los Estados Unidos) y ninguna otra reclamación sobre las convenciones que se usan en estados Unidos, como el sistema de medición o la moneda.

Ejemplo:

Windows.Globalization.ApplicationLanguages.PrimaryLanguageOverride = "en-US"

Nota

Si la aplicación pasa etiquetas de idioma de esta clase a cualquier función de soporte técnico de idioma nacional , primero debe convertir las etiquetas llamando a ResolveLocaleName.

Las etiquetas de lenguaje admiten las extensiones Unicode "ca-" y "nu-". (Consulte Definiciones de clave/tipo Unicode). Tenga en cuenta que estas extensiones pueden afectar al sistema numérico o al calendario utilizado por los objetos de globalización.

Las aplicaciones para UWP se pueden implementar mediante paquetes de recursos. Cuando se usan paquetes de recursos de idioma, los paquetes que se instalan y registran para un usuario determinado vienen determinados por los idiomas del perfil de idioma del usuario. Como resultado, no todos los idiomas incluidos en la agrupación de aplicaciones que se enviaron a Microsoft Store estarán disponibles necesariamente para su uso en tiempo de ejecución. La propiedad PrimaryLanguageOverride solo debe establecerse en idiomas disponibles para el usuario.

Los idiomas disponibles para que la aplicación se use como un objeto ApplicationLanguages en tiempo de ejecución se limitan a los idiomas incluidos en el manifiesto del paquete de aplicación principal y los idiomas correspondientes a los paquetes de recursos de idioma aplicables al usuario (determinados por los idiomas coincidentes en las preferencias del usuario) y que se instalan y registran para el usuario. La propiedad ApplicationLanguages.ManifestLanguages refleja los paquetes de recursos de idioma que están disponibles para el usuario y devuelve un conjunto adecuado de idiomas que se pueden usar para establecer la propiedad PrimaryLanguageOverride .

La propiedad ApplicationLanguages.Languages devolverá una lista muy similar a la propiedad ManifestLanguages . Puede diferir en incluir variaciones de idioma regionales no enumeradas en ningún manifiesto de paquete; Por ejemplo, la propiedad Languages puede devolver "en-CA" (Inglés (Canadá)) si el usuario tiene "en-CA" en su perfil y la aplicación admite cualquier variedad regional de inglés. Estas variaciones de idioma regional derivadas del usuario pueden ser preferibles para establecer la propiedad PrimaryLanguageOverride , ya que la aplicación proporcionará comportamientos de globalización más adecuados para el usuario.

Si un idioma está en el paquete de la aplicación principal, pero no coincide con ningún idioma en la preferencia del usuario, la propiedad ManifestLanguages la devuelve, pero no la propiedad Languages . También se pueden usar para establecer la propiedad PrimaryLanguageOverride . Sin embargo, dado que estos idiomas no se reflejan en las preferencias del usuario, es posible que el usuario no comprenda esos idiomas. Esta configuración solo se debe usar cuando el usuario lo elija directamente.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1803	17134	GetLanguagesForUser

Propiedades

Languages	Obtiene una lista clasificada de los valores actuales del lenguaje en tiempo de ejecución preferidos por el usuario.
ManifestLanguages	Obtiene la lista declarada de la aplicación de idiomas admitidos.
PrimaryLanguageOverride	Obtiene o establece una invalidación para el idioma preferido de la aplicación, expresada como una etiqueta de idioma BCP-47 . Esta configuración se conserva.

Métodos

GetLanguagesForUser(User)

Recupera las preferencias de idioma del usuario especificado. Esta API forma parte de la compatibilidad con aplicaciones multiusuario (MUA).

Consulte también

• Etiquetas de idioma BCP-47
• Definiciones de clave/tipo Unicode