Método ITextFont::SetForeColor (tom.h)

Artigo
03/02/2024

Define a cor de primeiro plano (texto).

Sintaxe

HRESULT SetForeColor(
  [in] long Value
);

Parâmetros

[in] Value

Tipo: long

A nova cor de primeiro plano. Pode ser um dos seguintes.

Valor	Significado
Um valor COLORREF.	Uma cor RGB.
Um valor retornado por PALETTEINDEX	Um índice de paleta.
tomUndefined	Nenhuma alteração.
tomAutoColor	Use a cor de primeiro plano padrão.

Se Value contiver uma cor RGB, gere COLORREF usando a macro RGB .

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Se o método falhar, ele retornará um dos seguintes códigos de erro COM. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno	Descrição
E_INVALIDARG	Argumento inválido.
CO_E_RELEASED	O objeto de fonte é anexado a um intervalo que foi excluído.
E_ACCESSDENIED	Acesso de gravação negado.
E_OUTOFMEMORY	Memória insuficiente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	tom.h
DLL	Msftedit.dll