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 |