Función ScriptSubstituteSingleGlyph (usp10.h)

Artículo
08/26/2023

Habilita la sustitución de un único glifo con una forma alternativa del mismo glifo para el procesamiento de OpenType.

Sintaxis

HRESULT ScriptSubstituteSingleGlyph(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           OPENTYPE_TAG    tagLangSys,
  [in]           OPENTYPE_TAG    tagFeature,
  [in]           LONG            lParameter,
  [in]           WORD            wGlyphId,
  [out]          WORD            *pwOutGlyphId
);

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 indica 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 modelado para que se use el glifo sustituto correcto.

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 para dar forma.

[in] tagLangSys

Estructura OPENTYPE_TAG que define la etiqueta de lenguaje para dar forma.

[in] tagFeature

Estructura OPENTYPE_TAG que define la etiqueta de característica que se va a usar para dar forma al glifo alternativo.

[in] lParameter

Referencia al glifo alternativo que se va a sustituir. Esta referencia es un índice de una matriz que contiene todos los glifos alternativos definidos en la característica, como se muestra para OPENTYPE_FEATURE_RECORD. La matriz de glifo alternativo es uno de los elementos recuperados por ScriptGetFontAlternateGlyphs.

[in] wGlyphId

Identificador del glifo original.

[out] pwOutGlyphId

Puntero a la ubicación en la que esta función recupera el identificador del glifo alternativo.

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 .

Comentarios

Esta función usa una sustitución uno a uno en la que la aplicación puede sustituir un glifo con una forma alternativa. Normalmente, las aplicaciones usan esta función para establecer una viñeta o un glifo alternativo al principio o al final de una línea.

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