IDWriteTextAnalyzer ::GetGlyphPlacements, méthode (dwrite.h)
Places sortie des glyphes de la méthode GetGlyphes en fonction de la police et des règles de rendu du système d’écriture.
Syntaxe
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
);
Paramètres
[in] textString
Type : const WCHAR*
Tableau de caractères contenant la chaîne d’origine d’où proviennent les glyphes.
[in] clusterMap
Type : const UINT16*
Pointeur vers le mappage des plages de caractères aux plages de glyphes. Cette valeur est retournée par GetGlyphes.
[in] textProps
Type : DWRITE_SHAPING_TEXT_PROPERTIES*
Pointeur vers un tableau de structures qui contient des propriétés de mise en forme pour chaque caractère. Cette structure est retournée par GetGlyphes.
textLength
Type : UINT32
Longueur de texte de textString.
[in] glyphIndices
Type : const UINT16*
Tableau d’index de glyphes retournés par GetGlyphes.
[in] glyphProps
Type : const DWRITE_SHAPING_GLYPH_PROPERTIES*
Pointeur vers un tableau de structures qui contiennent des propriétés de mise en forme pour chaque glyphe retourné par GetGlyphes.
glyphCount
Type : UINT32
Nombre de glyphes retournés par GetGlyphes.
fontFace
Type : IDWriteFontFace*
Pointeur vers la face de police qui est la source des glyphes de sortie.
fontEmSize
Type : FLOAT
Taille de police logique dans les DIPs.
isSideways
Type : BOOL
Indicateur booléen défini sur TRUE si le texte est destiné à être dessiné verticalement.
isRightToLeft
Type : BOOL
Indicateur booléen défini sur TRUE pour le texte de droite à gauche.
[in] scriptAnalysis
Type : const DWRITE_SCRIPT_ANALYSIS*
Pointeur vers un résultat d’analyse de script à partir d’un appel AnalyzeScript .
[in, optional] localeName
Type : const WCHAR*
Tableau de caractères contenant les paramètres régionaux à utiliser lors de la sélection de glyphes. Par exemple, le même caractère peut être mappé à différents glyphes pour ja-jp et zh-chs. Si cette valeur est NULL, le mappage par défaut basé sur le script est utilisé.
[in, optional] features
Type : const DWRITE_TYPOGRAPHIC_FEATURES**
Tableau de pointeurs vers les ensembles de caractéristiques typographiques à utiliser dans chaque plage de caractéristiques.
[in, optional] featureRangeLengths
Type : const UINT32*
Longueur de chaque plage de caractéristiques, en caractères.
La somme de toutes les longueurs doit être égale à textLength.
featureRanges
Type : UINT32
Nombre de plages de fonctionnalités.
[out] glyphAdvances
Type : FLOAT*
Lorsque cette méthode est retournée, contient la largeur avancée de chaque glyphe.
[out] glyphOffsets
Type : DWRITE_GLYPH_OFFSET*
Lorsque cette méthode est retournée, contient le décalage de l’origine de 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.
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP] |
Serveur minimal pris en charge | Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau | Applications UWP] |
Plateforme cible | Windows |
En-tête | dwrite.h |
Bibliothèque | Dwrite.lib |
DLL | Dwrite.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour