Export (0) Print
Expand All

ITextFont::SetBackColor method

Sets the background color.

Syntax


HRESULT SetBackColor(
  [in]  long Value
);

Parameters

Value [in]

Type: long

The new background color. It can be one of the following.

ValueMeaning
A COLORREF value.An RGB color.
A value returned by PALETTEINDEX A palette index.
tomUndefinedNo change.
tomAutoColorUse the default background color.

 

If Value contains an RGB color, generate the COLORREF by using the RGB macro.

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 codeDescription
E_INVALIDARG

Invalid argument.

CO_E_RELEASED

The font object is attached to a range that has been deleted.

E_ACCESSDENIED

Write access is denied.

E_OUTOFMEMORY

Insufficient memory.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Tom.h

DLL

Msftedit.dll

See also

Reference
ITextFont
GetBackColor
Conceptual
Text Object Model
Other Resources
COLORREF
PALETTEINDEX
RGB

 

 

Community Additions

ADD
Show:
© 2014 Microsoft