IDWriteTextAnalyzer1::GetJustificationOpportunities, méthode (dwrite_1.h)

Article
08/23/2023

Récupère les informations d’opportunité de justification pour chacun des glyphes en fonction du texte et des propriétés de mise en forme des glyphes.

Syntaxe

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
);

Paramètres

fontFace

Type : IDWriteFontFace*

Visage de police utilisé pour la mise en forme. Ceci est principalement important pour retourner des résultats corrects de la largeur de kashida.

Peut être NULL.

fontEmSize

Type : FLOAT

Taille de police utilisée pour l’exécution du glyphe.

scriptAnalysis

Type : DWRITE_SCRIPT_ANALYSIS

Script du texte à partir de l’itemizer.

textLength

Type : UINT32

Longueur du texte.

glyphCount

Type : UINT32

Nombre de glyphes.

[in] textString

Type : const WCHAR*

Caractères utilisés pour produire les glyphes.

[in] clusterMap

Type : const UINT16*

Clustermap produit à partir de la mise en forme.

[in] glyphProperties

Type : const DWRITE_SHAPING_GLYPH_PROPERTIES*

Propriétés du glyphe produites à partir de la mise en forme.

[out] justificationOpportunities

Type : DWRITE_JUSTIFICATION_OPPORTUNITY*

Pointeur vers une structure de DWRITE_JUSTIFICATION_OPPORTUNITY qui reçoit des informations sur l’expansion/compression de justification autorisée pour chaque glyphe.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Cette fonction est appelée par exécution, une fois la mise en forme effectuée via la méthode IDWriteTextAnalyzer::GetGlyphs .

Notez que cette fonction prend uniquement en charge les métriques naturelles (DWRITE_MEASURING_MODE_NATURAL).

Spécifications


Client minimal pris en charge	Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 et Platform Update pour Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	dwrite_1.h
Bibliothèque	Dwrite_1.lib
DLL	Dwrite_1.dll

Voir aussi

IDWriteTextAnalyzer1

Partager via