Метод ITextRange::SetFont (tom.h)
Задает атрибуты символов этого диапазона для указанного объекта ITextFont .
Синтаксис
HRESULT SetFont(
[in] ITextFont *pFont
);
Параметры
[in] pFont
Тип: ITextFont*
Объект шрифта с нужным символьным форматом.
Возвращаемое значение
Тип: HRESULT
Метод возвращает значение HRESULT . Если метод завершается успешно, он возвращает S_OK. Если метод завершается сбоем, он возвращает один из следующих кодов ошибок. Дополнительные сведения о кодах ошибок COM см. в разделе Обработка ошибок в COM.
| Код возврата | Описание |
|---|---|
|
Значение |
|
Текст защищен. |
|
pFont имеет значение NULL. |
|
Недостаточно памяти. |
Комментарии
Для случайных изменений формата используйте метод ITextRange::SetFont . Тем не менее, чтобы внести ряд изменений в форматирование символов, эффективнее использовать дубликат шрифта. Это связано с тем, что при каждом выполнении инструкции, такой как range.font.bold = tomTrue, объект шрифта выделяется и освобождается. Однако дубликаты шрифта можно выделить один раз и использовать много раз. Кроме того, можно сохранить дубликат шрифта, сбросить его в состояние по умолчанию или неопределенное с помощью метода Reset и присвоить ему значения для обработки форматированного текста. Пример кода, демонстрирующий использование дубликатов шрифтов, см. в разделе Использование дубликата шрифта.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | tom.h |
| DLL | Msftedit.dll |
См. также раздел
Основные понятия
Справочные материалы