Метод ITextRange::SetFont (tom.h)

  • Статья

Задает атрибуты символов этого диапазона для указанного объекта ITextFont .

Синтаксис

HRESULT SetFont(
  [in] ITextFont *pFont
);

Параметры

[in] pFont

Тип: ITextFont*

Объект шрифта с нужным символьным форматом.

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

Тип: HRESULT

Метод возвращает значение HRESULT . Если метод завершается успешно, он возвращает S_OK. Если метод завершается сбоем, он возвращает один из следующих кодов ошибок. Дополнительные сведения о кодах ошибок COM см. в разделе Обработка ошибок в COM.

Код возврата Описание
Значение
 Значение
E_ACCESSDENIED
 Текст защищен.
E_INVALIDARG
 pFont имеет значение NULL.
E_OUTOFMEMORY
 Недостаточно памяти.

Комментарии

Для случайных изменений формата используйте метод ITextRange::SetFont . Тем не менее, чтобы внести ряд изменений в форматирование символов, эффективнее использовать дубликат шрифта. Это связано с тем, что при каждом выполнении инструкции, такой как range.font.bold = tomTrue, объект шрифта выделяется и освобождается. Однако дубликаты шрифта можно выделить один раз и использовать много раз. Кроме того, можно сохранить дубликат шрифта, сбросить его в состояние по умолчанию или неопределенное с помощью метода Reset и присвоить ему значения для обработки форматированного текста. Пример кода, демонстрирующий использование дубликатов шрифтов, см. в разделе Использование дубликата шрифта.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header tom.h
DLL Msftedit.dll

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

Основные понятия

ITextRange

Справочные материалы

Сброс

Текстовая объектная модель