IDWriteFontFace::GetGlyphIndices-Methode (dwrite.h)
Gibt die nominale Zuordnung von UCS4-Unicode-Codepunkten zu Glyphenindizes zurück, die in der Tabelle "CMAP" der Schriftart definiert sind.
Syntax
HRESULT GetGlyphIndices(
[in] UINT32 const *codePoints,
UINT32 codePointCount,
[out] UINT16 *glyphIndices
);
Parameter
[in] codePoints
Typ: const UINT32*
Ein Array von USC4-Codepunkten, aus dem nominale Glyphenindizes abgerufen werden sollen. Das Array muss zugeordnet sein und die Anzahl der von codePointCount angegebenen Elemente enthalten können.
codePointCount
Typ: UINT32
Die Anzahl der Elemente im codePoints-Array .
[out] glyphIndices
Typ: UINT16*
Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein Array von nominalen Glyphenindizes, die von dieser Funktion ausgefüllt werden.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Beachten Sie, dass diese Zuordnung in erster Linie für Linienlayout-Engines bereitgestellt wird, die auf der API für physische Schriftarten basieren. Aufgrund der OpenType-Glyphenersetzung und der Zeilenlayoutzeichenersetzung entspricht die Nominalkonvertierung nicht immer der Zuordnung einer Unicode-Zeichenfolge zu Glyphenindizes beim Rendern mit einer bestimmten Schriftart. Beachten Sie außerdem, dass Unicode-Variantenselektoren alternative Zuordnungen für Zeichen zur Glyphe bereitstellen. Dieser Aufruf gibt immer die Standardvariante zurück.
Wenn Zeichen in der Schriftart nicht vorhanden sind, gibt diese Methode den Index 0 zurück, d. h. die nicht definierte Glyphe oder die ".notdef"-Glyphe. Wenn sich ein Zeichen nicht in einer Schriftart befindet, gibt IDWriteFont::HasCharacter false zurück, und GetUnicodeRanges gibt es nicht im Bereich zurück.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dwrite.h |
| Bibliothek | Dwrite.lib |
| DLL | Dwrite.dll |