IDWriteTextAnalyzer::GetGlyphPlacements-Methode (dwrite.h)
Places Glyphen, die von der GetGlyphs-Methode gemäß der Schriftart und den Renderingregeln des Schreibsystems ausgegeben werden.
Syntax
HRESULT GetGlyphPlacements(
[in] WCHAR const *textString,
[in] UINT16 const *clusterMap,
[in] DWRITE_SHAPING_TEXT_PROPERTIES *textProps,
UINT32 textLength,
[in] UINT16 const *glyphIndices,
[in] DWRITE_SHAPING_GLYPH_PROPERTIES const *glyphProps,
UINT32 glyphCount,
IDWriteFontFace *fontFace,
FLOAT fontEmSize,
BOOL isSideways,
BOOL isRightToLeft,
[in] DWRITE_SCRIPT_ANALYSIS const *scriptAnalysis,
[in, optional] WCHAR const *localeName,
[in, optional] DWRITE_TYPOGRAPHIC_FEATURES const **features,
[in, optional] UINT32 const *featureRangeLengths,
UINT32 featureRanges,
[out] FLOAT *glyphAdvances,
[out] DWRITE_GLYPH_OFFSET *glyphOffsets
);
Parameter
[in] textString
Typ: const WCHAR*
Ein Zeichenarray, das die ursprüngliche Zeichenfolge enthält, aus der die Glyphen stammen.
[in] clusterMap
Typ: const UINT16*
Ein Zeiger auf die Zuordnung von Zeichenbereichen zu Glyphenbereichen. Dies wird von GetGlyphen zurückgegeben.
[in] textProps
Typ: DWRITE_SHAPING_TEXT_PROPERTIES*
Ein Zeiger auf ein Array von Strukturen, das Formeigenschaften für jedes Zeichen enthält. Diese Struktur wird von GetGlyphen zurückgegeben.
textLength
Typ: UINT32
Die Textlänge von textString.
[in] glyphIndices
Typ: const UINT16*
Ein Array von Glyphenindizes, die von GetGlyphen zurückgegeben werden.
[in] glyphProps
Typ: const DWRITE_SHAPING_GLYPH_PROPERTIES*
Ein Zeiger auf ein Array von Strukturen, die Gestaltungseigenschaften für jede von GetGlyphen zurückgegebene Glyphe enthalten.
glyphCount
Typ: UINT32
Die Anzahl der von GetGlyphen zurückgegebenen Glyphen.
fontFace
Typ: IDWriteFontFace*
Ein Zeiger auf die Schriftart, die die Quelle für die Ausgabeglyphen ist.
fontEmSize
Typ: FLOAT
Der logische Schriftgrad in DIPs.
isSideways
Typ: BOOL
Ein boolesches Flag, das auf TRUE festgelegt ist, wenn der Text vertikal gezeichnet werden soll.
isRightToLeft
Typ: BOOL
Ein boolesches Flag, das für Text von rechts nach links auf TRUE festgelegt ist.
[in] scriptAnalysis
Typ: const DWRITE_SCRIPT_ANALYSIS*
Ein Zeiger auf eine Skriptanalyse resultiert aus einem AnalyzeScript-Aufruf .
[in, optional] localeName
Typ: const WCHAR*
Ein Array von Zeichen, das das Gebietsschema enthält, das bei der Auswahl von Glyphen verwendet werden soll. Beispielsweise kann dasselbe Zeichen verschiedenen Glyphen für ja-jp im Vergleich zu zh-chs zugeordnet werden. Wenn dies NULL ist, wird die Standardzuordnung basierend auf dem Skript verwendet.
[in, optional] features
Typ: const DWRITE_TYPOGRAPHIC_FEATURES**
Ein Array von Zeigern auf die Sätze typografischer Features, die in jedem Featurebereich verwendet werden sollen.
[in, optional] featureRangeLengths
Typ: const UINT32*
Die Länge jedes Featurebereichs in Zeichen.
Die Summe aller Längen sollte gleich textLength sein.
featureRanges
Typ: UINT32
Die Anzahl der Featurebereiche.
[out] glyphAdvances
Typ: FLOAT*
Wenn diese Methode zurückgibt, enthält die Erweiterte Breite der einzelnen Glyphen.
[out] glyphOffsets
Typ: DWRITE_GLYPH_OFFSET*
Wenn diese Methode zurückgibt, enthält den Offset des Ursprungs der einzelnen Glyphen.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
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 |