ScriptApplyLogicalWidth-Funktion (usp10.h)

Artikel
03/03/2024

Verwendet ein Array von erweiterten Breiten für eine Ausführung und generiert ein Array von angepassten erweiterten Glyphenbreiten.

Syntax

HRESULT ScriptApplyLogicalWidth(
  [in]                const int             *piDx,
  [in]                int                   cChars,
  [in]                int                   cGlyphs,
  [in]                const WORD            *pwLogClust,
  [in]                const SCRIPT_VISATTR  *psva,
  [in]                const int             *piAdvance,
  [in]                const SCRIPT_ANALYSIS *psa,
  [in, out, optional] ABC                   *pABC,
  [out]               int                   *piJustify
);

Parameter

[in] piDx

Zeiger auf ein Array von Erweiterten Breiten in logischer Reihenfolge, eine pro Codepunkt.

[in] cChars

Anzahl der logischen Codepunkte in der Ausführung.

[in] cGlyphs

Glyphenanzahl.

[in] pwLogClust

Zeiger auf ein Array logischer Cluster aus ScriptShape.

[in] psva

Zeiger auf eine SCRIPT_VISATTR Struktur aus ScriptShape und aktualisiert durch ScriptPlace.

[in] piAdvance

Zeiger auf ein Array von Glyphenvorschubbreiten aus ScriptPlace.

[in] psa

Zeiger auf eine SCRIPT_ANALYSIS Struktur aus ScriptItemize und aktualisiert von ScriptShape und ScriptPlace.

[in, out, optional] pABC

Zeiger auf die allgemeine ABC-Breite einer Ausführung. Bei der Eingabe sollte der Parameter die abc-Ausführungsbreiten enthalten, die von ScriptPlace abgerufen werden. Bei der Ausgabe gibt der Parameter die ABC-Breite an, die aktualisiert wurde, um den neuen Breiten zu entsprechen.

[out] piJustify

Zeiger auf ein Array, in dem die Funktion die Glyphenvorschubbreiten abruft. Dieses Array eignet sich für die Übergabe an den piJustify-Parameter von ScriptTextOut.

Rückgabewert

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

Hinweise

Diese Funktion kann verwendet werden, um logische Breiten, die mit ScriptGetLogicalWidths abgerufen wurden, erneut anzuweisen. Dies kann in Situationen wie Metafiling nützlich sein, für die Informationen zur Erweiterten Breite aufgezeichnet und auf schriftartunabhängige Weise neu angewendet werden müssen, unabhängig von Glyphenersetzungen, z. B. Ligaturisierung.

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 der Bibliotheksliste angeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	usp10.h
Bibliothek	Usp10.lib
DLL	Usp10.dll
Verteilbare Komponente	Internet Explorer 5 oder höher unter Windows Me/98/95