IDWriteTextLayout ::SetFontWeight, méthode (dwrite.h)
Définit l’épaisseur de police du texte dans une plage de texte spécifiée par une structure DWRITE_TEXT_RANGE .
Syntaxe
HRESULT SetFontWeight(
DWRITE_FONT_WEIGHT fontWeight,
DWRITE_TEXT_RANGE textRange
);
Paramètres
fontWeight
Type : DWRITE_FONT_WEIGHT
Poids de police à définir pour le texte dans la plage spécifiée par textRange.
textRange
Type : DWRITE_TEXT_RANGE
Plage de texte à laquelle cette modification s’applique.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
La pondération de police peut être définie sur l’une des valeurs prédéfinies de poids de police fournies dans l’énumération DWRITE_FONT_WEIGHT ou un entier compris entre 1 et 999. Les valeurs en dehors de cette plage entraînent l’échec de la méthode avec une valeur de retour E_INVALIDARG .
L’illustration suivante montre un exemple de poids Normal et UltraBold pour la police Palatino Linotype.
Exemples
Le code suivant montre comment définir l’épaisseur de police sur gras.
// Set the font weight to bold for the entire string.
DWRITE_TEXT_RANGE textRange = {0, cTextLength_};
if (SUCCEEDED(hr))
{
hr = pTextLayout_->SetFontWeight(DWRITE_FONT_WEIGHT_BOLD, textRange);
}
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 Platform Update pour Windows Server 2008 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | dwrite.h |
| Bibliothèque | Dwrite.lib |
| DLL | Dwrite.dll |