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

Article
02/29/2024

Récupère une liste de 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 passées à 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 a été exécutée avec succès.
E_NOT_SUFFICIENT_BUFFER	La mémoire tampon est trop petite. ActualRangeCount était supérieur à maxRangeCount.

Remarques

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

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 caractère unique ou une série de caractères uniques successivement, par exemple 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

IDWriteFontFace1

Partager via