Función ScriptGetFontFeatureTags (usp10.h)

Artículo
08/26/2023

Recupera una lista de características tipográficas para el sistema de escritura definido para el procesamiento de OpenType. Las etiquetas de características tipográficas que componen la lista se recuperan de la fuente en el contexto o caché del dispositivo proporcionado.

Sintaxis

HRESULT ScriptGetFontFeatureTags(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           OPENTYPE_TAG    tagLangSys,
  [in]           int             cMaxTags,
  [out]          OPENTYPE_TAG    *pFeatureTags,
  [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 características de fuente para la fuente y los scripts adecuados.

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

[in] tagScript

Estructura OPENTYPE_TAG que define la etiqueta de script asociada a las etiquetas de características especificadas.

[in] tagLangSys

Estructura OPENTYPE_TAG que define la etiqueta de idioma asociada a las etiquetas de características especificadas.

[in] cMaxTags

Longitud de la matriz especificada por pFeatureTags.

[out] pFeatureTags

Puntero a un búfer en el que esta función recupera una matriz de estructuras de OPENTYPE_TAG que definen las etiquetas de características tipográficas admitidas por la fuente en el contexto del dispositivo o la memoria caché del sistema de escritura definido.

[out] pcTags

Puntero al número de elementos de la matriz de etiquetas de características.

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 el valor de 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, una 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, la etiqueta de característica de la característica Ligature es "liga".

Esta función oculta las características necesarias para script o necesarias para el lenguaje porque el motor de forma controla estas características. La aplicación no tiene control sobre el control del motor de forma para las características necesarias para el lenguaje. Por ejemplo, ScriptGetFontFeatureTags oculta las características del script árabe para los formularios iniciales, multimedia y finales.

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

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