IDWriteTextAnalyzer::GetGlyphs-Methode (dwrite.h)

Analysiert die Eingabetextzeichenfolge und ordnet sie dem Satz von Glyphen und zugeordneten Glyphendaten gemäß der Schriftart und den Renderingregeln des Schreibsystems zu.

Syntax

HRESULT GetGlyphs(
  [in]           WCHAR const                       *textString,
                 UINT32                            textLength,
                 IDWriteFontFace                   *fontFace,
                 BOOL                              isSideways,
                 BOOL                              isRightToLeft,
  [in]           DWRITE_SCRIPT_ANALYSIS const      *scriptAnalysis,
  [in, optional] WCHAR const                       *localeName,
  [optional]     IDWriteNumberSubstitution         *numberSubstitution,
  [in, optional] DWRITE_TYPOGRAPHIC_FEATURES const **features,
  [in, optional] UINT32 const                      *featureRangeLengths,
                 UINT32                            featureRanges,
                 UINT32                            maxGlyphCount,
  [out]          UINT16                            *clusterMap,
  [out]          DWRITE_SHAPING_TEXT_PROPERTIES    *textProps,
  [out]          UINT16                            *glyphIndices,
  [out]          DWRITE_SHAPING_GLYPH_PROPERTIES   *glyphProps,
  [out]          UINT32                            *actualGlyphCount
);

Parameter

[in] textString

Typ: const WCHAR*

Ein Array von Zeichen, die in Glyphen konvertiert werden sollen.

textLength

Typ: UINT32

Die Länge von textString.

fontFace

Typ: IDWriteFontFace*

Die Schriftart, die die Quelle der Ausgabeglyphen ist.

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*

Das Gebietsschema, 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.

[optional] numberSubstitution

Typ: IDWriteNumberSubstitution*

Ein Zeiger auf eine optionale Zahlenersetzung, die abhängig von den Ergebnissen aus AnalyzeNumberSubstitution die entsprechenden Glyphen für Ziffern und zugehörige numerische Zeichen auswählt. Das Übergeben von NULL gibt an, dass keine Ersetzung erforderlich ist und dass die Ziffern nominale Glyphen erhalten sollen.

[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.

maxGlyphCount

Typ: UINT32

Die maximale Anzahl von Glyphen, die zurückgegeben werden können.

[out] clusterMap

Typ: UINT16*

Wenn diese Methode zurückgibt, enthält die Zuordnung von Zeichenbereichen zu Glyphenbereichen.

[out] textProps

Typ: DWRITE_SHAPING_TEXT_PROPERTIES*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein Array von Strukturen, das Formeigenschaften für jedes Zeichen enthält.

[out] glyphIndices

Typ: UINT16*

Die Ausgabeglyphenindizes.

[out] glyphProps

Typ: DWRITE_SHAPING_GLYPH_PROPERTIES*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein Array von Strukturen, die Gestaltungseigenschaften für jede Ausgabe-Glyphe enthalten.

[out] actualGlyphCount

Typ: UINT32*

Wenn diese Methode zurückgibt, enthält die tatsächliche Anzahl von Glyphen, die zurückgegeben werden, wenn der Aufruf erfolgreich ist.

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 die Zuordnung von Zeichen zu Glyphen im Allgemeinen viele zu viele ist. Die empfohlene Schätzung für die Ausgabepuffer pro Glyphen ist (3 * textLength / 2 + 16). Dies ist nicht garantiert ausreichend.

Der Wert des parameters actualGlyphCount ist nur gültig, wenn der Aufruf erfolgreich ist. Falls maxGlyphCount nicht groß genug ist, wird HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) zurückgegeben. Die Anwendung sollte einen größeren Puffer zuweisen und es erneut versuchen.

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

Weitere Informationen

IDWriteTextAnalyzer