GetGlyphIndicesW-Funktion (wingdi.h)

Artikel
11/20/2024

Die GetGlyphIndices-Funktion übersetzt eine Zeichenfolge in ein Array von Glyphenindizes. Die Funktion kann verwendet werden, um zu bestimmen, ob eine Glyphe in einer Schriftart vorhanden ist.

Syntax

DWORD GetGlyphIndicesW(
  [in]  HDC     hdc,
  [in]  LPCWSTR lpstr,
  [in]  int     c,
  [out] LPWORD  pgi,
  [in]  DWORD   fl
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] lpstr

Ein Zeiger auf die zu konvertierende Zeichenfolge.

[in] c

Die Länge der Länge der Zeichenfolge durch lpstr und die Größe (in WORDs) des Puffers, auf den pgiverweist.

[out] pgi

Dieser Puffer muss die Dimension c aufweisen. Bei erfolgreicher Rückgabe enthält ein Array von Glyphenindizes, die den Zeichen in der Zeichenfolge entsprechen.

[in] fl

Gibt an, wie Glyphen behandelt werden sollen, wenn sie nicht unterstützt werden. Dieser Parameter kann der folgende Wert sein.

Wert	Bedeutung
GGI_MARK_NONEXISTING_GLYPHS	Markiert nicht unterstützte Glyphen mit dem hexadezimalen Wert 0xffff.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie die Anzahl der Bytes (für die ANSI-Funktion) oder WORDs (für die Unicode-Funktion) zurück.

Wenn die Funktion fehlschlägt, wird der Rückgabewert GDI_ERROR.

Bemerkungen

Diese Funktion versucht, für jedes Zeichen in der Zeichenfolge, auf das durch lpstrverwiesen wird, eine Einzelglyphendarstellung zu identifizieren. Dies ist zwar für bestimmte Zwecke auf niedriger Ebene (z. B. das Bearbeiten von Schriftartdateien) nützlich, aber Anwendungen auf höherer Ebene, die eine Zeichenfolge zu Glyphen zuordnen möchten, möchten in der Regel die funktionen Uniscribe verwenden.

Anmerkung

Der wingdi.h-Header definiert GetGlyphIndices als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wingdi.h (enthalten Windows.h)
Library	Gdi32.lib
DLL-	Gdi32.dll

Siehe auch

Schriftart- und Textfunktionen

Schriftarten und Textübersicht

GetFontUnicodeRanges

Freigeben über