ScriptGetLogicalWidths-Funktion (usp10.h)

Artikel
03/06/2024

Konvertiert die Glyphenbreiten für eine bestimmte Schriftart in logische Breiten.

Syntax

HRESULT ScriptGetLogicalWidths(
  [in]  const SCRIPT_ANALYSIS *psa,
  [in]  int                   cChars,
  [in]  int                   cGlyphs,
  [in]  const int             *piGlyphWidth,
  [in]  const WORD            *pwLogClust,
  [in]  const SCRIPT_VISATTR  *psva,
  [out] int                   *piDx
);

Parameter

[in] psa

Zeiger auf eine SCRIPT_ANALYSIS-Struktur .

[in] cChars

Anzahl der logischen Codepunkte in der Ausführung.

[in] cGlyphs

Anzahl der Glyphen in der Ausführung.

[in] piGlyphWidth

Zeiger auf ein Array von Erweiterten Glyphenbreiten.

[in] pwLogClust

Zeiger auf ein Array logischer Cluster.

[in] psva

Zeiger auf eine SCRIPT_VISATTR Struktur, die visuelle Attribute definiert.

[out] piDx

Zeiger auf ein Array mit logischen Breiten.

Rückgabewert

Gibt derzeit in allen Fällen S_OK zurück.

Hinweise

Diese Funktion ist nützlich, um Breiten auf schriftartunabhängige Weise aufzuzeichnen. Es konvertiert die für eine bestimmte Schriftart berechneten Glyphenvorlaufbreiten in logische Breiten ( eine pro Codepunkt) in der gleichen Reihenfolge wie die Codepunkte. Wenn dieselbe Zeichenfolge dann auf einem anderen Gerät mit einer anderen Schriftart angezeigt wird, können die logischen Breiten mithilfe von ScriptApplyLogicalWidth angewendet werden, um der ursprünglichen Platzierung zu entsprechen. Dieser Mechanismus ist bei der Implementierung der Druckvorschau nützlich. Auf dem Vorschaubildschirm ist es wichtig, das Layout und die Platzierung des endgültigen gedruckten Ergebnisses abzugleichen.

Hinweis Ligaturglyphenbreiten werden gleichmäßig auf die Zeichen aufgeteilt, die sie darstellen.

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