IDWriteTextLayout ::SetFontWeight, méthode (dwrite.h)

  • Article

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.

Illustration de la lettre « W » en poids Normal et UltraBold

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

Voir aussi

IDWriteTextLayout