Поделиться через

Метод IDWriteFactory::CreateGdiCompatibleTextLayout (dwrite.h)

  • Статья

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

Синтаксис

HRESULT CreateGdiCompatibleTextLayout(
  [in]           WCHAR const         *string,
                 UINT32              stringLength,
                 IDWriteTextFormat   *textFormat,
                 FLOAT               layoutWidth,
                 FLOAT               layoutHeight,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
  [out]          IDWriteTextLayout   **textLayout
);

Параметры

[in] string

Тип: const WCHAR*

Массив символов, содержащий строку для создания нового объекта IDWriteTextLayout . Этот массив должен иметь длину stringLength и может содержать внедренные символы NULL .

stringLength

Тип: UINT32

Длина строки в количестве символов.

textFormat

Тип: IDWriteTextFormat*

Объект форматирования текста, применяемый к строке.

layoutWidth

Тип: FLOAT

Ширина поля макета.

layoutHeight

Тип: FLOAT

Высота поля макета.

pixelsPerDip

Тип: FLOAT

Количество физических пикселей на DIP (независимый от устройства пиксель). Например, если отрисовка на устройстве с разрешением 96 DPI пикселейPerDip имеет значение 1. Если отрисовка на устройстве с разрешением 120 пикселейPerDip равно 1,25 (120/96).

[in, optional] transform

Тип: const DWRITE_MATRIX*

Необязательное преобразование, применяемое к глифам и их позициям. Это преобразование применяется после того, как масштабирование задает размер шрифта и пиксели на DIP.

useGdiNatural

Тип: BOOL

Указывает макету текста использовать те же метрики, что и двухуровневый текст GDI, если задано значение FALSE. Если задано значение TRUE, макет текста будет использовать те же метрики, что и текст, измеряемый GDI, с помощью шрифта, созданного с помощью CLEARTYPE_NATURAL_QUALITY.

[out] textLayout

Тип: IDWriteTextLayout**

При возврате этим методом содержит адрес на указатель результирующий объект текстового макета.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Результирующий макет текста следует использовать только для предполагаемого разрешения, а в случаях, когда требуется масштабируемость текста, следует использовать CreateTextLayout .

Требования

Требование Значение
Минимальная версия клиента 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
Библиотека Dwrite.lib
DLL Dwrite.dll

См. также раздел

IDWriteFactory