Partager via


Interface IDWriteTextFormat (dwrite.h)

L’interface IDWriteTextFormat décrit les propriétés de police et de paragraphe utilisées pour mettre en forme le texte, ainsi que les informations de paramètres régionaux.

Héritage

L’interface IDWriteTextFormat hérite de l’interface IUnknown. IDWriteTextFormat a également les types de membres suivants :

Méthodes

L’interface IDWriteTextFormat utilise ces méthodes.

 
IDWriteTextFormat::GetFlowDirection

Obtient la direction du flux des lignes de texte.
IDWriteTextFormat::GetFontCollection

Obtient la collection de polices actuelle.
IDWriteTextFormat::GetFontFamilyName

Obtient une copie du nom de la famille de polices.
IDWriteTextFormat::GetFontFamilyNameLength

Obtient la longueur du nom de la famille de polices.
IDWriteTextFormat::GetFontSize

Obtient la taille de police dans les units DIP.
IDWriteTextFormat::GetFontStretch

Obtient l’étendue de police du texte.
IDWriteTextFormat::GetFontStyle

Obtient le style de police du texte.
IDWriteTextFormat::GetFontWeight

Obtient le poids de police du texte.
IDWriteTextFormat::GetIncrementalTabStop

Obtient la position incrémentielle du taquet de tabulation.
IDWriteTextFormat::GetLineSpacing

Obtient le jeu d’ajustement d’espacement de ligne pour un paragraphe de texte multiligne. (IDWriteTextFormat.GetLineSpacing)
IDWriteTextFormat::GetLocaleName

Obtient une copie du nom des paramètres régionaux.
IDWriteTextFormat::GetLocaleNameLength

Obtient la longueur du nom des paramètres régionaux.
IDWriteTextFormat::GetParagraphAlignment

Obtient l’option d’alignement d’un paragraphe relatif aux bords supérieur et inférieur d’une zone de disposition.
IDWriteTextFormat::GetReadingDirection

Obtient le sens de lecture actuel pour le texte d’un paragraphe.
IDWriteTextFormat::GetTextAlignment

Obtient l’option d’alignement du texte par rapport au bord de début et de fin de la zone de disposition.
IDWriteTextFormat::GetTrimming

Obtient les options de découpage pour le texte qui dépasse la zone de disposition.
IDWriteTextFormat::GetWordWrapping

Obtient l’option d’habillage du mot.
IDWriteTextFormat::SetFlowDirection

Définit le sens du flux de paragraphe.
IDWriteTextFormat::SetIncrementalTabStop

Définit une distance fixe entre deux taquets de tabulation adjacents.
IDWriteTextFormat::SetLineSpacing

Définit l’espacement des lignes.
IDWriteTextFormat::SetParagraphAlignment

Définit l’option d’alignement d’un paragraphe par rapport au bord supérieur et inférieur de la zone de disposition.
IDWriteTextFormat::SetReadingDirection

Définit le sens de lecture du paragraphe.
IDWriteTextFormat::SetTextAlignment

Définit l’alignement du texte dans un paragraphe, par rapport au bord de début et de fin d’une zone de disposition pour une interface IDWriteTextFormat.
IDWriteTextFormat::SetTrimming

Définit les options de découpage pour le texte dépassant la largeur de la disposition.
IDWriteTextFormat::SetWordWrapping

Définit l’option de habillage du mot.

Notes

Pour obtenir une référence à l’interface IDWriteTextFormat , l’application doit appeler la méthode IDWriteFactory::CreateTextFormat , comme indiqué dans le code suivant.


if (SUCCEEDED(hr))
{
    hr = pDWriteFactory_->CreateTextFormat(
        L"Gabriola",
        NULL,
        DWRITE_FONT_WEIGHT_REGULAR,
        DWRITE_FONT_STYLE_NORMAL,
        DWRITE_FONT_STRETCH_NORMAL,
        72.0f,
        L"en-us",
        &pTextFormat_
        );
}


Lors de la création d’un objet IDWriteTextFormat à l’aide de la fonction CreateTextFormat , l’application spécifie la famille de polices, la collection de polices, le poids de police, la taille de police et le nom des paramètres régionaux pour le format de texte.

Ces propriétés ne peuvent pas être modifiées après la création de l’objet IDWriteTextFormat . Pour modifier ces propriétés, un nouvel objet IDWriteTextFormat doit être créé avec les propriétés souhaitées.

L’interface IDWriteTextFormat est utilisée pour dessiner du texte avec un format unique

Pour dessiner du texte avec plusieurs formats ou utiliser un convertisseur de texte personnalisé, utilisez l’interface IDWriteTextLayout . IDWriteTextLayout permet à l’application de modifier le format des plages de texte dans la chaîne. IDWriteFactory::CreateTextLayout prend un objet IDWriteTextFormat en tant que paramètre et applique initialement les informations de format à la chaîne entière.

Cet objet peut ne pas être thread-safe et il peut porter l’état de la modification de format de texte.

DirectWrite et Direct2D

Pour dessiner du texte simple avec un format unique, Direct2D fournit la méthode ID2D1RenderTarget::D rawText , qui dessine une chaîne à l’aide des informations de format fournies par un objet IDWriteTextFormat .

Spécifications

   
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