MÉTHODE IDWriteFontFallback ::MapCharacters (dwrite_2.h)

Article
02/29/2024

Détermine une police appropriée à utiliser pour afficher la plage de texte de début.

Syntaxe

HRESULT MapCharacters(
                 IDWriteTextAnalysisSource *analysisSource,
                 UINT32                    textPosition,
                 UINT32                    textLength,
  [in, optional] IDWriteFontCollection     *baseFontCollection,
  [in, optional] wchar_t const             *baseFamilyName,
                 DWRITE_FONT_WEIGHT        baseWeight,
                 DWRITE_FONT_STYLE         baseStyle,
                 DWRITE_FONT_STRETCH       baseStretch,
  [out]          UINT32                    *mappedLength,
  [out]          IDWriteFont               **mappedFont,
  [out]          FLOAT                     *scale
);

Paramètres

analysisSource

Type : IDWriteTextAnalysisSource*

L’implémentation de la source de texte contient le texte et les paramètres régionaux.

textPosition

Type : UINT32

Position de départ à analyser.

textLength

Type : UINT32

Longueur du texte à analyser.

[in, optional] baseFontCollection

Type : IDWriteFontCollection*

Collection de polices par défaut à utiliser.

[in, optional] baseFamilyName

Type : const wchar_t*

Nom de famille de la police de base. Si vous transmettez null, aucune correspondance ne sera effectuée par rapport à la famille.

baseWeight

Type : DWRITE_FONT_WEIGHT

Poids souhaité.

baseStyle

Type : DWRITE_FONT_STYLE

Style souhaité.

baseStretch

Type : DWRITE_FONT_STRETCH

Étirement souhaité.

[out] mappedLength

Type : UINT32*

Longueur du texte mappé à la police mappée. Cela sera toujours inférieur ou égal à la longueur du texte et supérieur à zéro (si la longueur du texte est différente de zéro), de sorte que l’appelant avance au moins un caractère.

[out] mappedFont

Type : IDWriteFont**

Police qui doit être utilisée pour afficher les premiers caractères mapLength du texte. Si elle retourne NULL, cela signifie qu’aucune police ne peut afficher le texte, et mapLength est le nombre de caractères à ignorer (rendu avec un glyphe manquant).

[out] scale

Type : FLOAT*

Facteur d’échelle pour multiplier la taille em de la police retournée par.

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 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	dwrite_2.h
Bibliothèque	Dwrite.lib
DLL	Dwrite.dll

Voir aussi

IDWriteFontFallback

Partager via