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 |
|
| DLL |
|