GetKerningPairsW-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 GetKerningPairsW(
  [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 vom Parameter nNumPairs 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 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

Übersicht über Schriftarten und Text

KERNINGPAIR