IDWriteFont1 ::GetUnicodeRanges, méthode (dwrite_1.h)

Article
02/29/2024

Récupère la liste des plages de caractères prises en charge par une police.

Syntaxe

HRESULT GetUnicodeRanges(
                  UINT32               maxRangeCount,
  [out, optional] DWRITE_UNICODE_RANGE *unicodeRanges,
  [out]           UINT32               *actualRangeCount
);

Paramètres

maxRangeCount

Type : UINT32

Nombre maximal de plages de caractères transmises à partir du client.

[out, optional] unicodeRanges

Type : DWRITE_UNICODE_RANGE*

Tableau de structures DWRITE_UNICODE_RANGE qui sont remplies avec les plages de caractères.

[out] actualRangeCount

Type : UINT32*

Pointeur vers le nombre réel de plages de caractères, quel que soit le nombre maximal.

Valeur retournée

Type : HRESULT

Cette méthode peut retourner l’une de ces valeurs.

Valeur retournée	Description
S_OK	La méthode s’est exécutée avec succès.
E_NOT_SUFFICIENT_BUFFER	La mémoire tampon est trop petite. ActualRangeCount était plus que maxRangeCount.

Remarques

La liste des plages de caractères prises en charge par une police est utile pour les scénarios tels que la sélection de caractères, l’affichage des glyphes et la recherche efficace de la sélection des polices. GetUnicodeRanges est similaire à GetFontUnicodeRanges de GDI, sauf qu’il retourne la plage Unicode complète, pas seulement 16 bits UCS-2.

Ces plages proviennent du cmap, et non de OS/2 ::ulCodePageRange1.

Si cette méthode n’est pas disponible, vous pouvez utiliser la méthode IDWriteFontFace ::GetGlyphIndices pour case activée pour les glyphes manquants. La méthode retourne l’index 0 pour les glyphes qui ne sont pas présents dans la police.

La méthode IDWriteFont ::HasCharacter est souvent plus simple dans les cas où vous devez case activée un seul caractère ou une série de caractères uniques successivement, comme dans la police de secours.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	dwrite_1.h
Bibliothèque	Dwrite_1.lib
DLL	Dwrite_1.dll

Voir aussi

IDWriteFont1

Partager via