Compartir a través de

Función OleTranslateColor (olectl.h)

  • Artículo

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