IDWriteFontFace1::GetKerningPairAdjustments-Methode (dwrite_1.h)
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 |