ITextFont::GetForeColor method (tom.h)

Gets the foreground, or text, color.

Syntax

HRESULT GetForeColor(
  long *pValue
);

Parameters

pValue

Type: long*

The foreground color. It can be one of the following values.

Value Meaning
A COLORREF value The high-order byte is zero, and the three low-order bytes specify an RGB color.
A value returned by PALETTEINDEX The high-order byte is 1, and the LOWORD specifies the index of a logical-color palette entry.
tomAutocolor (-9999997) Indicates that the range uses the default system foreground color.

Return value

Type: HRESULT

If the method succeeds, it returns S_OK. If the method fails, it returns one of the following COM error codes. For more information about COM error codes, see Error Handling in COM.

Return code Description
E_INVALIDARG
Invalid argument.
CO_E_RELEASED
The font object is attached to a range that has been deleted.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header tom.h
DLL Msftedit.dll

See also

COLORREF

Conceptual

ITextFont

Other Resources

PALETTEINDEX

Reference

SetForeColor

Text Object Model