Partager via

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

  • Article

Détermine le mode de rendu recommandé pour la police, à l’aide des paramètres de taille et de rendu spécifiés.

Syntaxe

HRESULT GetRecommendedRenderingMode(
                 FLOAT                    fontEmSize,
                 FLOAT                    dpiX,
                 FLOAT                    dpiY,
  [in, optional] DWRITE_MATRIX const      *transform,
                 BOOL                     isSideways,
                 DWRITE_OUTLINE_THRESHOLD outlineThreshold,
                 DWRITE_MEASURING_MODE    measuringMode,
  [out]          DWRITE_RENDERING_MODE    *renderingMode
);

Paramètres

fontEmSize

Type : FLOAT

Taille logique de la police en unités DIP. Un DIP (« pixel indépendant de l’appareil ») est égal à 1/96 pouce.

dpiX

Type : FLOAT

Nombre de pixels physiques par DIP dans une position horizontale. Par exemple, si le DPI de la surface de rendu est 96, cette valeur est 1,0f. Si le DPI est 120, cette valeur est 120.0f/96.

dpiY

Type : FLOAT

Nombre de pixels physiques par DIP dans une position verticale. Par exemple, si le DPI de la surface de rendu est 96, cette valeur est 1,0f. Si le DPI est 120, cette valeur est 120.0f/96.

[in, optional] transform

Type : const DWRITE_MATRIX*

Spécifie la transformation du monde.

isSideways

Type : BOOL

Indique si les glyphes en cours d’exécution sont de côté ou non.

outlineThreshold

Type : DWRITE_OUTLINE_THRESHOLD

Une valeur de type DWRITE_OUTLINE_THRESHOLD qui spécifie la qualité du rendu des contours du système graphique affecte le seuil de taille au-dessus duquel le rendu du plan est utilisé.

measuringMode

Type : DWRITE_MEASURING_MODE

Méthode de mesure qui sera utilisée pour les glyphes dans la police. Les implémentations de renderer peuvent choisir différents modes de rendu pour différentes méthodes de mesure, par exemple :

[out] renderingMode

Type : DWRITE_RENDERING_MODE*

Lorsque cette méthode retourne, contient une valeur qui indique le mode de rendu recommandé à utiliser.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode doit être utilisée pour déterminer le mode de rendu réel dans les cas où le mode de rendu de l’objet params de rendu est DWRITE_RENDERING_MODE_DEFAULT.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [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