Функция ScriptSubstituteSingleGlyph (usp10.h)

Статья
08/26/2023

Включает подстановку одного глифа одной альтернативной формой того же глифа для обработки OpenType.

Синтаксис

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
);

Параметры

[in, optional] hdc

Обработка в контексте устройства. Дополнительные сведения см. в разделе Кэширование.

[in, out] psc

Указатель на структуру SCRIPT_CACHE , указывающую кэш скрипта.

[in, optional] psa

Указатель на структуру SCRIPT_ANALYSIS , полученную при предыдущем вызове ScriptItemizeOpenType. Этот параметр определяет подсистему формирования, чтобы использовать правильный заменяющий глиф.

Кроме того, приложение может задать для этого параметра значение NULL , чтобы получить нефильтрованные результаты.

[in] tagScript

Структура OPENTYPE_TAG , определяющая тег скрипта для формирования.

[in] tagLangSys

Структура OPENTYPE_TAG , определяющая языковой тег для формирования.

[in] tagFeature

Структура OPENTYPE_TAG , определяющая тег признака, используемый для формирования альтернативного глифа.

[in] lParameter

Ссылка на замещающий глиф. Эта ссылка представляет собой индекс массива, содержащего все альтернативные глифы, определенные в компоненте, как показано для OPENTYPE_FEATURE_RECORD. Альтернативный массив глифов является одним из элементов, извлекаемых ScriptGetFontAlternateGlyphs.

[in] wGlyphId

Идентификатор исходного глифа.

[out] pwOutGlyphId

Указатель на расположение, в котором эта функция получает идентификатор альтернативного глифа.

Возвращаемое значение

Возвращает 0 в случае успеха. Функция возвращает ненулевое значение HRESULT, если это не удалось. Приложение может проверить возвращаемое значение с помощью макросов SUCCEEDED и FAILED .

Эта функция использует подстановку "один к одному", в которой приложение может заменить один глиф одной альтернативной формой. Чаще всего приложения используют эту функцию для установки маркера или альтернативного глифа в начале или конце строки.

Важно Начиная с Windows 8. Чтобы поддерживать возможность запуска в Windows 7, модуль, использующий Uniscribe, должен указать Usp10.lib перед gdi32.lib в списке библиотек.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	usp10.h
Библиотека	Usp10.lib
DLL	Usp10.dll
Распространяемые компоненты	Usp10.dll версии 1.600 или более поздней в Windows XP