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

Article
03/05/2025

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

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 les résultats corrects de la largeur de kashida.

Peut être NULL.

fontEmSize

Type : FLOAT

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

scriptAnalysis

Type : DWRITE_SCRIPT_ANALYSIS

Script du texte 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 de glyphe produites à partir de la mise en forme.

[out] justificationOpportunities

Type : DWRITE_JUSTIFICATION_OPPORTUNITY*

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

Valeur de retour

Type : HRESULT

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

Remarques

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

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8 et Mise à jour de plateforme pour Windows 7 [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2012 et Mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	dwrite_1.h
bibliothèque	Dwrite_1.lib
DLL	Dwrite_1.dll

Voir aussi

IDWriteTextAnalyzer1

Partager via