Compartilhar via

Função OleTranslateColor (olectl.h)

  • Artigo

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