ScriptSubstituteSingleGlyph-Funktion (usp10.h)

Artikel
03/06/2024

Ermöglicht das Ersetzen einer einzelnen Glyphe durch eine alternative Form derselben Glyphe für die OpenType-Verarbeitung.

Syntax

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

Parameter

[in, optional] hdc

Handle mit dem Gerätekontext. Weitere Informationen finden Sie unter Zwischenspeichern.

[in, out] psc

Zeiger auf eine SCRIPT_CACHE Struktur, die den Skriptcache angibt.

[in, optional] psa

Zeiger auf eine SCRIPT_ANALYSIS Struktur, die aus einem vorherigen Aufruf von ScriptItemizeOpenType abgerufen wurde. Dieser Parameter identifiziert die Formgebungs-Engine, sodass die richtige Ersatz-Glyphe verwendet wird.

Alternativ kann die Anwendung diesen Parameter auf NULL festlegen, um ungefilterte Ergebnisse abzurufen.

[in] tagScript

Eine OPENTYPE_TAG Struktur, die das Skripttag für die Gestaltung definiert.

[in] tagLangSys

Eine OPENTYPE_TAG Struktur, die das Sprachtag für die Gestaltung definiert.

[in] tagFeature

Eine OPENTYPE_TAG Struktur, die das Featuretag definiert, das zum Gestalten der alternativen Glyphe verwendet werden soll.

[in] lParameter

Verweis auf die alternative Glyphe, die ersetzt werden soll. Dieser Verweis ist ein Index für ein Array, das alle im Feature definierten alternativen Glyphen enthält, wie für OPENTYPE_FEATURE_RECORD dargestellt. Das alternative Glyphenarray ist eines der Elemente, die von ScriptGetFontAlternateGlyphs abgerufen werden.

[in] wGlyphId

Bezeichner der ursprünglichen Glyphe.

[out] pwOutGlyphId

Zeiger auf den Speicherort, an dem diese Funktion den Bezeichner der alternativen Glyphe abruft.

Rückgabewert

Gibt bei Erfolg 0 zurück. Die Funktion gibt einen nichtzero-HRESULT-Wert zurück, wenn er nicht erfolgreich ist. Die Anwendung kann den Rückgabewert mit den Makros SUCCEEDED und FAILED testen.

Hinweise

Diese Funktion verwendet eine 1:1-Ersetzung, bei der die Anwendung eine Glyphe durch eine alternative Form ersetzen kann. Am häufigsten verwenden Anwendungen diese Funktion, um ein Aufzählungszeichen oder eine alternative Glyphe am Anfang oder Ende einer Zeile festzulegen.

Wichtig Ab Windows 8: Um die Ausführung unter Windows 7 zu gewährleisten, muss ein Modul, das Uniscribe verwendet, Usp10.lib vor gdi32.lib in seiner Bibliotheksliste angeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	usp10.h
Bibliothek	Usp10.lib
DLL	Usp10.dll
Verteilbare Komponente	Usp10.dll Version 1.600 oder höher unter Windows XP