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

Weitere Informationen

IDWriteFontFace