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