Função OleTranslateColor (olectl.h)

Converte um tipo de OLE_COLOR em um COLORREF.

Sintaxe

WINOLECTLAPI OleTranslateColor(
  [in]  OLE_COLOR clr,
  [in]  HPALETTE  hpal,
  [out] COLORREF  *lpcolorref
);

Parâmetros

[in] clr

A cor OLE a ser convertida em um COLORREF.

[in] hpal

Paleta usada como base para a conversão.

[out] lpcolorref

Ponteiro para a variável do chamador que recebe o resultado COLORREF convertido. Esse parâmetro pode ser NULL, indicando que o chamador deseja apenas verificar se existe uma cor convertida.

Retornar valor

Essa função dá suporte aos valores retornados padrão E_INVALIDARG e E_UNEXPECTED, bem como ao valor a seguir.

Código de retorno	Descrição
S_OK	A cor foi traduzida com êxito.

Comentários

A tabela a seguir descreve a conversão de cores.

OLE_COLOR	hPal	COLORREF
inválido		Indefinido (E_INVALIDARG)
0x800000xx, xx não é um índice GetSysColor válido		Indefinido (E_INVALIDARG)
	inválido	Indefinido (E_INVALIDARG)
0x0100iiii, iiii não é um índice de paleta válido	paleta válida	Indefinido (E_INVALIDARG)
0x800000xx, xx é um índice GetSysColor válido	NULL	0x00bbggrr
0x0100iiii, iiii é um índice de paleta válido	NULL	0x0100iiii
0x02bbggrr (relativo da paleta)	NULL	0x02bbggrr
0x00bbggrr	NULL	0x00bbggrr
0x800000xx, xx é um índice GetSysColor válido	paleta válida	0x00bbggrr
0x0100iiii, iiii é um índice de paleta válido no hPal	paleta válida	0x0100iiii
0x02bbggrr (relativo da paleta)	paleta válida	0x02bbggrr
0x00bbggrr	paleta válida	0x02bbggrr

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	olectl.h
Biblioteca	OleAut32.lib
DLL	OleAut32.dll