Интерфейс IDWriteTextFormat (dwrite.h)

Интерфейс IDWriteTextFormat описывает свойства шрифта и абзаца, используемые для форматирования текста, а также сведения о языковом стандарте.

Наследование

Интерфейс IDWriteTextFormat наследуется от интерфейса IUnknown . IDWriteTextFormat также имеет следующие типы элементов:

Методы

Интерфейс IDWriteTextFormat содержит следующие методы.

IDWriteTextFormat::GetFlowDirection Возвращает направление потока текстовых линий.
IDWriteTextFormat::GetFontCollection Возвращает текущую коллекцию шрифтов.
IDWriteTextFormat::GetFontFamilyName Возвращает копию имени семейства шрифтов.
IDWriteTextFormat::GetFontFamilyNameLength Возвращает длину имени семейства шрифтов.
IDWriteTextFormat::GetFontSize Возвращает размер шрифта в объединениях DIP.
IDWriteTextFormat::GetFontStretch Возвращает растяжение шрифта текста.
IDWriteTextFormat::GetFontStyle Возвращает стиль шрифта текста.
IDWriteTextFormat::GetFontWeight Возвращает вес шрифта текста.
IDWriteTextFormat::GetIncrementalTabStop Возвращает позицию остановки добавочного табуляции.
IDWriteTextFormat::GetLineSpacing Возвращает набор настроек междустрочного интервала для абзаца многострочного текста. (IDWriteTextFormat.GetLineSpacing)
IDWriteTextFormat::GetLocaleName Возвращает копию имени языкового стандарта.
IDWriteTextFormat::GetLocaleNameLength Возвращает длину имени языкового стандарта.
IDWriteTextFormat::GetParagraphAlignment Возвращает параметр выравнивания абзаца относительно верхнего и нижнего краев поля макета.
IDWriteTextFormat::GetReadingDirection Возвращает текущее направление чтения для текста в абзаце.
IDWriteTextFormat::GetTextAlignment Возвращает параметр выравнивания текста относительно начального и конечного краев поля макета.
IDWriteTextFormat::GetTrimming Возвращает параметры обрезки для текста, переполняющего поле макета.
IDWriteTextFormat::GetWordWrapping Возвращает параметр переноса слов.
IDWriteTextFormat::SetFlowDirection Задает направление потока абзаца.
IDWriteTextFormat::SetIncrementalTabStop Задает фиксированное расстояние между двумя смежными остановками табуляции.
IDWriteTextFormat::SetLineSpacing Задает междустрочный интервал.
IDWriteTextFormat::SetParagraphAlignment Задает параметр выравнивания абзаца относительно верхнего и нижнего краев окна макета.
IDWriteTextFormat::SetReadingDirection Задает направление чтения абзаца.
IDWriteTextFormat::SetTextAlignment Задает выравнивание текста в абзаце относительно начальной и конечной границы поля макета для интерфейса IDWriteTextFormat.
IDWriteTextFormat::SetTrimming Задает параметры обрезки для переполнения текста ширины макета.
IDWriteTextFormat::SetWordWrapping Задает параметр упаковки по словам.

Комментарии

Чтобы получить ссылку на интерфейс IDWriteTextFormat , приложение должно вызвать метод IDWriteFactory::CreateTextFormat , как показано в следующем коде.

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_
        );
}

При создании объекта IDWriteTextFormat с помощью функции CreateTextFormat приложение указывает семейство шрифтов, коллекцию шрифтов, вес шрифта, размер шрифта и имя языкового стандарта для текстового формата.

Эти свойства нельзя изменить после создания объекта IDWriteTextFormat . Чтобы изменить эти свойства, необходимо создать новый объект IDWriteTextFormat с требуемыми свойствами.

Интерфейс IDWriteTextFormat используется для рисования текста в одном формате

Чтобы нарисовать текст в нескольких форматах или использовать пользовательский отрисовщик текста, используйте интерфейс IDWriteTextLayout . IDWriteTextLayout позволяет приложению изменять формат для диапазонов текста в строке. IDWriteFactory::CreateTextLayout принимает объект IDWriteTextFormat в качестве параметра и изначально применяет сведения о формате ко всей строке.

Этот объект не может быть потокобезопасн, и он может переносить состояние изменения формата текста.

DirectWrite и Direct2D

Чтобы нарисовать простой текст в одном формате, Direct2D предоставляет метод ID2D1RenderTarget::D rawText , который рисует строку, используя сведения о формате, предоставляемые объектом IDWriteTextFormat .

Требования

Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	dwrite.h