GetKerningPairsA-Funktion (wingdi.h)
Die GetKerningPairs-Funktion ruft die Zeichen-Kerning-Paare für die aktuell ausgewählte Schriftart für den angegebenen Gerätekontext ab.
Syntax
DWORD GetKerningPairsA(
[in] HDC hdc,
[in] DWORD nPairs,
[out] LPKERNINGPAIR lpKernPair
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext.
[in] nPairs
Die Anzahl der Paare im lpkrnpair-Array . Wenn die Schriftart mehr als nNumPairs-Kerningpaare aufweist, gibt die Funktion einen Fehler zurück.
[out] lpKernPair
Ein Zeiger auf ein Array von KERNINGPAIR-Strukturen , das die Kerningpaare empfängt. Das Array muss mindestens so viele Strukturen enthalten, wie durch den nNumPairs-Parameter angegeben. Wenn dieser Parameter NULL ist, gibt die Funktion die Gesamtzahl der Kerningpaare für die Schriftart zurück.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der zurückgegebenen Kerningpaare.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Hinweis
Der wingdi.h-Header definiert GetKerningPairs 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
| 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 (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |
Weitere Informationen
Schriftart- und Textfunktionen