IDWriteTextAnalyzer1::GetJustificationOpportunities-Methode (dwrite_1.h)

Artikel
08/23/2023

Ruft die Informationen zur Rechtfertigungschancen für jede der Glyphen ab, die den Text und die Eigenschaften der Formgebung enthalten.

Syntax

HRESULT GetJustificationOpportunities(
        IDWriteFontFace                       *fontFace,
        FLOAT                                 fontEmSize,
        DWRITE_SCRIPT_ANALYSIS                scriptAnalysis,
        UINT32                                textLength,
        UINT32                                glyphCount,
  [in]  WCHAR const                           *textString,
  [in]  UINT16 const                          *clusterMap,
  [in]  DWRITE_SHAPING_GLYPH_PROPERTIES const *glyphProperties,
  [out] DWRITE_JUSTIFICATION_OPPORTUNITY      *justificationOpportunities
);

Parameter

fontFace

Typ: IDWriteFontFace*

Schriftart, die für die Gestaltung verwendet wurde. Dies ist vor allem wichtig, um korrekte Ergebnisse der Kashida-Breite zurückzugeben.

Kann NULL sein.

fontEmSize

Typ: FLOAT

Schriftgrad, der für die Ausführung der Glyphen verwendet wird.

scriptAnalysis

Typ: DWRITE_SCRIPT_ANALYSIS

Skript des Texts aus dem Elementisierer.

textLength

Typ: UINT32

Länge des Texts.

glyphCount

Typ: UINT32

Anzahl der Glyphen.

[in] textString

Typ: const WCHAR*

Zeichen, die zum Erzeugen der Glyphen verwendet werden.

[in] clusterMap

Typ: const UINT16*

Clustermap, die aus der Gestaltung erstellt wurde.

[in] glyphProperties

Typ: const DWRITE_SHAPING_GLYPH_PROPERTIES*

Glypheneigenschaften, die aus der Formgebung erzeugt werden.

[out] justificationOpportunities

Typ: DWRITE_JUSTIFICATION_OPPORTUNITY*

Ein Zeiger auf eine DWRITE_JUSTIFICATION_OPPORTUNITY-Struktur , die Informationen für die zulässige Rechtfertigungserweiterung/-komprimierung für jede Glyphe empfängt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Funktion wird pro Ausführung aufgerufen, nachdem die Gestaltung über die IDWriteTextAnalyzer::GetGlyphs-Methode erfolgt ist.

Beachten Sie, dass diese Funktion nur natürliche Metriken (DWRITE_MEASURING_MODE_NATURAL) unterstützt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	dwrite_1.h
Bibliothek	Dwrite_1.lib
DLL	Dwrite_1.dll

Weitere Informationen

IDWriteTextAnalyzer1

Freigeben über