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

Weitere Informationen

IDWriteTextAnalyzer