MÉTHODE IDWriteFontFace3::GetRecommendedRenderingMode (dwrite_3.h)

Détermine le rendu du texte recommandé et le mode d’ajustement de la grille à utiliser en fonction de la police, de la taille, de la transformation universelle et du mode de mesure.

Syntaxe

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

Paramètres

[in] fontEmSize

Type : FLOAT

Taille de police logique dans les DIPs.

[in] dpiX

Type : FLOAT

Nombre de pixels par pouce logique dans la direction horizontale.

[in] dpiY

Type : FLOAT

Nombre de pixels par pouce logique dans la direction verticale.

[in, optional] transform

Type : const DWRITE_MATRIX*

Structure DWRITE_MATRIX qui décrit la transformation du monde.

[in] isSideways

Type : BOOL

Spécifie si la police est latérale. TRUE si la police est latérale ; sinon, FALSE.

[in] outlineThreshold

Type : DWRITE_OUTLINE_THRESHOLD

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é.

[in] measuringMode

Type : DWRITE_MEASURING_MODE

Valeur DWRITE_MEASURING_MODE typée qui spécifie la méthode utilisée pour mesurer pendant la mise en page du texte. Pour un espacement approprié des glyphes, cette méthode retourne un mode de rendu compatible avec le mode de mesure spécifié.

[in, optional] renderingParams

Type : IDWriteRenderingParams*

Pointeur vers une interface IDWriteRenderingParams pour l’objet paramètres de rendu. Ce paramètre est nécessaire si l’objet de paramètres de rendu remplace le mode de rendu.

[out] renderingMode

Type : DWRITE_RENDERING_MODE1*

Pointeur vers une variable qui reçoit une valeur de type DWRITE_RENDERING_MODE1 pour le mode de rendu recommandé.

[out] gridFitMode

Type : DWRITE_GRID_FIT_MODE*

Pointeur vers une variable qui reçoit une valeur de type DWRITE_GRID_FIT_MODE pour le mode d’ajustement de grille recommandé.

Valeur retournée

Type : HRESULT

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

Spécifications

Client minimal pris en charge	Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	dwrite_3.h
Bibliothèque	Dwrite.lib
DLL	Dwrite.dll

Voir aussi

IDWriteFontFace3