Función OleTranslateColor (olectl.h)

Convierte un tipo de OLE_COLOR en COLORREF.

Sintaxis

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

Parámetros

[in] clr

Color OLE que se va a convertir en COLORREF.

[in] hpal

Paleta usada como base para la conversión.

[out] lpcolorref

Puntero a la variable del autor de la llamada que recibe el resultado DE COLORREF convertido. Este parámetro puede ser NULL, lo que indica que el autor de la llamada solo quiere comprobar que existe un color convertido.

Valor devuelto

Esta función admite los valores devueltos estándar E_INVALIDARG y E_UNEXPECTED, así como el siguiente valor.

Código devuelto	Descripción
S_OK	El color se ha traducido correctamente.

Comentarios

En la tabla siguiente se describe la conversión de color.

OLE_COLOR	hPal	COLORREF
no válido		Sin definir (E_INVALIDARG)
0x800000xx, xx no es un índice GetSysColor válido		Sin definir (E_INVALIDARG)
	no válido	Sin definir (E_INVALIDARG)
0x0100iiii, iiii no es un índice de paleta válido	paleta válida	Sin definir (E_INVALIDARG)
0x800000xx, xx es un índice GetSysColor válido	NULL	0x00bbggrr
0x0100iiii, iiii es un índice de paleta válido	NULL	0x0100iiii
0x02bbggrr (relativo a la paleta)	NULL	0x02bbggrr
0x00bbggrr	NULL	0x00bbggrr
0x800000xx, xx es un índice GetSysColor válido	paleta válida	0x00bbggrr
0x0100iiii, iiii es un índice de paleta válido en hPal	paleta válida	0x0100iiii
0x02bbggrr (relativo a la paleta)	paleta válida	0x02bbggrr
0x00bbggrr	paleta válida	0x02bbggrr

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	olectl.h
Library	OleAut32.lib
Archivo DLL	OleAut32.dll