Freigeben über

IDWriteFontFace1::GetKerningPairAdjustments-Methode (dwrite_1.h)

  • Artikel

Ruft die Kerningpaaranpassungen aus der Kerntabelle der Schriftart ab.

Syntax

HRESULT GetKerningPairAdjustments(
        UINT32       glyphCount,
  [in]  UINT16 const *glyphIndices,
  [out] INT32        *glyphAdvanceAdjustments
);

Parameter

glyphCount

Typ: UINT32

Anzahl der Glyphen, für die Anpassungen abgerufen werden sollen.

[in] glyphIndices

Typ: const UINT16*

Ein Array von Glyphen-IDs, für die Anpassungen abgerufen werden sollen.

[out] glyphAdvanceAdjustments

Typ: INT32*

Die Fortschritte, die in Schriftentwurfseinheiten für jede Glyphe zurückgegeben werden. Die letzte Glyphenanpassung ist null.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

GetKerningPairAdjustments ist kein direkter Ersatz für die zeichenbasierten GetKerningPairs von GDI, aber es erfüllt die gleiche Rolle, ohne dass der Client sie lokal zwischenspeichern muss. GetKerningPairAdjustments verwendet auch die Glyphen-IDs direkt anstelle von UCS-2-Zeichen (wie die Kerntabelle sie tatsächlich speichert), wodurch Glyphenzusammenbrüche und Mehrdeutigkeiten vermieden werden, z. B. Bindestrich und Bindestrich, oder Leerzeichen und nicht unterbrechendes Leerzeichen.

Neuere Schriftarten verfügen möglicherweise nur über GPOS-Kerning anstelle des legacy-Paartabellen-Kernings. Solche Schriftarten, wie Gabriola, geben nur 0 für Anpassungen zurück. GetKerningPairAdjustments virtualisiert und vereinfacht diese GPOS-Einträge nicht in Kerningpaare.

Sie können einen Leistungsvorteil erzielen, indem Sie IDWriteFontFace1::HasKerningPairs aufrufen, um zu bestimmen, ob Sie GetKerningPairAdjustments aufrufen müssen. Wenn Sie zuvor IDWriteFontFace1::HasKerningPairs aufgerufen und FALSE zurückgegeben haben, können Sie den Aufruf von GetKerningPairAdjustments vermeiden, da die Schriftart keine Kerning-Tabellenpaareinträge enthält. Das heißt, in dieser Situation wäre ein Aufruf von GetKerningPairAdjustments ein No-Op.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile dwrite_1.h
Bibliothek Dwrite_1.lib
DLL Dwrite_1.dll

Weitere Informationen

IDWriteFontFace1

IDWriteFontFace1::HasKerningPairs