GetGlyphIndicesW-Funktion (wingdi.h)
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 sowohl der Länge der Zeichenfolge, auf die von lpstr verwiesen wird, als auch der Größe (in WORDs) des Puffers, auf den pgi verweist.
[out] pgi
Dieser Puffer muss die Dimension c aufweisen. Enthält bei erfolgreicher Rückgabe 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 |
---|---|
|
Markiert nicht unterstützte Glyphen mit dem Hexadezimalwert 0xffff. |
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie die Anzahl der konvertierten 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.
Hinweise
Diese Funktion versucht, eine Einzelne-Glyphe-Darstellung für jedes Zeichen in der Zeichenfolge zu identifizieren, auf die von lpstr verwiesen wird. Dies ist zwar für bestimmte Zwecke auf niedriger Ebene nützlich (z. B. das Bearbeiten von Schriftartdateien), aber Anwendungen auf höherer Ebene, die eine Zeichenfolge Glyphen zuordnen möchten, möchten in der Regel die Uniscribe-Funktionen verwenden.
Hinweis
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 nicht codierungsneutralem Code 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 |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | wingdi.h (einschließlich Windows.h) |
Bibliothek | Gdi32.lib |
DLL | Gdi32.dll |
Weitere Informationen
Schriftart- und Textfunktionen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für