Метод ITextFont::SetForeColor (tom.h)

Статья
03/02/2024

Задает цвет переднего плана (текста).

Синтаксис

HRESULT SetForeColor(
  [in] long Value
);

Параметры

[in] Value

Тип: long

Новый цвет переднего плана. Это может быть один из следующих вариантов.

Значение	Значение
Значение COLORREF .	Цвет RGB.
Значение, возвращаемое PALETTEINDEX	Индекс палитры.
tomUndefined	Без изменений.
tomAutoColor	Используйте цвет переднего плана по умолчанию.

Если значение содержит цвет RGB, создайте COLORREF с помощью макроса RGB .

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

Тип: HRESULT

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

Код возврата	Описание
E_INVALIDARG	Недопустимый аргумент.
CO_E_RELEASED	Объект шрифта прикрепляется к удаленному диапазону.
E_ACCESSDENIED	Доступ на запись запрещен.
E_OUTOFMEMORY	Недостаточно памяти.

Требования

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