Метод IDWriteTextLayout::SetFontWeight (dwrite.h)

  • Статья

Задает вес шрифта для текста в текстовом диапазоне, заданном структурой DWRITE_TEXT_RANGE .

Синтаксис

HRESULT SetFontWeight(
  DWRITE_FONT_WEIGHT fontWeight,
  DWRITE_TEXT_RANGE  textRange
);

Параметры

fontWeight

Тип: DWRITE_FONT_WEIGHT

Вес шрифта, задается для текста в диапазоне, заданном параметром textRange.

textRange

Тип: DWRITE_TEXT_RANGE

Диапазон текста, к которому применяется это изменение.

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

Тип: HRESULT

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

Комментарии

Для веса шрифта можно задать одно из предопределенных значений веса шрифта, указанных в перечислении DWRITE_FONT_WEIGHT , или целое число от 1 до 999. Значения за пределами этого диапазона приведут к сбою метода с возвращаемым значением E_INVALIDARG .

На следующем рисунке показан пример весов Normal и UltraBold для шрифта Palatino Linotype.

Иллюстрация буквы "W" в обычных весах и весах UltraBold

Примеры

В следующем коде показано, как задать для шрифта полужирный шрифт.


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

Требования

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

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

IDWriteTextLayout