Función ScriptGetFontLanguageTags (usp10.h)

Artículo
08/26/2023

Recupera una lista de etiquetas de idioma que están disponibles para el elemento especificado y son compatibles con una etiqueta de script especificada para el procesamiento de OpenType. Las etiquetas que componen la lista se recuperan de la fuente en el contexto o la memoria caché del dispositivo especificado.

Sintaxis

HRESULT ScriptGetFontLanguageTags(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           int             cMaxTags,
  [out]          OPENTYPE_TAG    *pLangsysTags,
  [out]          int             *pcTags
);

Parámetros

[in, optional] hdc

Identificador del contexto del dispositivo. Para más información, consulte Almacenamiento en caché.

[in, out] psc

Puntero a una estructura de SCRIPT_CACHE que identifica la caché de scripts.

[in, optional] psa

Puntero a una estructura de SCRIPT_ANALYSIS obtenida de una llamada anterior a ScriptItemizeOpenType. Este parámetro identifica el motor de forma, de modo que se puedan recuperar las etiquetas de idioma de fuente para la fuente y los scripts adecuados.

Como alternativa, la aplicación puede establecer este parámetro en NULL para recuperar los resultados sin filtrar.

[in] tagScript

Estructura OPENTYPE_TAG que define la etiqueta de script para la que se solicita la lista de etiquetas de idioma asociadas.

[in] cMaxTags

Longitud de la matriz especificada por pLangSysTags.

[out] pLangsysTags

Puntero a un búfer en el que esta función recupera una matriz de estructuras de OPENTYPE_TAG que identifican las etiquetas de idioma que coinciden con los criterios de entrada.

[out] pcTags

Puntero al número de elementos de la matriz de etiquetas de idioma.

Valor devuelto

Si la operación se realiza correctamente, devuelve 0. La función devuelve un valor HRESULT distinto de cero si no se realiza correctamente. La aplicación puede probar el valor devuelto con las macros SUCCEEDED y FAILED .

Si el número de etiquetas coincidentes supera cMaxTags, se produce un error en la función con E_OUTOFMEMORY. La aplicación puede intentar llamar de nuevo con búferes más grandes.

Comentarios

Aunque formalmente se declara como un tipo ULONG, la estructura de OPENTYPE_TAG contiene una matriz de 4 bytes que contiene cuatro valores ASCII de 8 bits de espacio, A-Z o a-z. Por ejemplo, las etiquetas de idioma para rumano, Urdu y persa son "ROM", "URD" y "FAR", respectivamente. Tenga en cuenta que cada etiqueta termina con un espacio.

Importante A partir de Windows 8: para mantener la capacidad de ejecutarse en Windows 7, un módulo que usa Uniscribe debe especificar Usp10.lib antes de gdi32.lib en su lista de bibliotecas.

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	usp10.h
Library	Usp10.lib
Archivo DLL	Usp10.dll
Redistribuible	Usp10.dll versión 1.600 o posterior en Windows XP