IDWriteFontFallback :: MapCharacters, méthode

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

Syntaxe

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

Paramètres

source

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.

baseFontCollection [ dans, facultatif]

Type : IDWriteFontCollection*

Collection de polices par défaut à utiliser.

baseFamilyName [ dans, facultatif]

Type : const WCHAR _ t *

Nom de famille de la police de base. Si vous transmettez la valeur null, aucune correspondance n’est effectuée par rapport à la famille.

baseWeight

Type : épaisseur de la _ police _ DWRITE

Poids souhaité.

baseStyle

Type : DWRITE _ _ style de police

Style souhaité.

baseStretch

Type : _ _ étirement de police DWRITE

Étirement souhaité.

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.

mappedFont [ à]

Type : IDWriteFont**

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

mise à l' échelle [ à]

Type : float *

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

Valeur de retour

Type : HRESULT

Si cette méthode est réussie, elle retourne la valeur _ OK. Sinon, elle retourne un code d’erreur HRESULT .

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 8.1 les [ applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2012 [Applications de bureau R2 uniquement]
Téléphone minimal pris en charge
Windows Phone 8,1 [ Windows Phone Silverlight 8,1 et applications Windows Runtime]
Bibliothèque
DWrite. lib
DLL
Dwrite.dll

Voir aussi

IDWriteFontFallback