IDWriteFontFace::GetDesignGlyphMetrics-Methode (dwrite.h)

Ruft ideale (auflösungsunabhängige) Glyphenmetriken in Schriftartentwurfseinheiten ab.

Syntax

HRESULT GetDesignGlyphMetrics(
  [in]  UINT16 const         *glyphIndices,
        UINT32               glyphCount,
  [out] DWRITE_GLYPH_METRICS *glyphMetrics,
        BOOL                 isSideways
);

Parameter

[in] glyphIndices

Typ: const UINT16*

Ein Array von Glyphenindizes, für die Metriken berechnet werden sollen. Das Array muss mindestens so viele Elemente enthalten, wie durch glyphCount angegeben.

glyphCount

Typ: UINT32

Die Anzahl der Elemente im glyphIndices-Array .

[out] glyphMetrics

Typ: DWRITE_GLYPH_METRICS*

Wenn diese Methode zurückgibt, enthält ein Array von DWRITE_GLYPH_METRICS Strukturen. glyphMetrics muss mit einem leeren Puffer initialisiert werden, der mindestens so viele Elemente wie glyphCount enthält. Die von dieser Funktion zurückgegebenen Metriken befinden sich in Schriftentwurfseinheiten.

isSideways

Typ: BOOL

Gibt an, ob die Schriftart in einer Seitlaufausführung verwendet wird. Dies kann sich auf die Glyphenmetriken auswirken, wenn die Schriftart über eine schräge Simulation verfügt, da sich die Seitwärtssimulation von der nicht seitlich schrägen Simulation unterscheidet.

Rückgabewert

Typ: HRESULT

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

Hinweise

Entwurfsglyphenmetriken werden für die Glyphenpositionierung verwendet.

Anforderungen

Anforderung	Wert
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

Weitere Informationen

IDWriteFontFace