Функция OleTranslateColor (olectl.h)

  • Статья

Преобразует тип OLE_COLOR в COLORREF.

Синтаксис

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

Параметры

[in] clr

Цвет OLE, преобразуемый в COLORREF.

[in] hpal

Палитра, используемая в качестве основы для преобразования.

[out] lpcolorref

Указатель на переменную вызывающего абонента, которая получает преобразованный результат COLORREF . Этот параметр может иметь значение NULL, указывая, что вызывающий объект хочет только проверить наличие преобразованного цвета.

Возвращаемое значение

Эта функция поддерживает стандартные возвращаемые значения E_INVALIDARG и E_UNEXPECTED, а также следующие значения.

Код возврата Описание
S_OK
 Цвет успешно переведен.

Комментарии

В следующей таблице описано преобразование цветов.

OLE_COLOR hPal COLORREF
недопустимо Неопределенный (E_INVALIDARG)
0x800000xx, xx не является допустимым индексом GetSysColor Неопределенный (E_INVALIDARG)
недопустимо Неопределенный (E_INVALIDARG)
0x0100iiii, iiii не является допустимым индексом палитры Допустимая палитра Неопределенный (E_INVALIDARG)
0x800000xx, xx — допустимый индекс GetSysColor . NULL 0x00bbggrr
0x0100iiii, iiii является допустимым индексом палитры NULL 0x0100iiii
0x02bbggrr (относительно палитры) NULL 0x02bbggrr
0x00bbggrr NULL 0x00bbggrr
0x800000xx, xx — допустимый индекс GetSysColor . Допустимая палитра 0x00bbggrr
0x0100iiii, iiii является допустимым индексом палитры в hPal Допустимая палитра 0x0100iiii
0x02bbggrr (относительно палитры) Допустимая палитра 0x02bbggrr
0x00bbggrr Допустимая палитра 0x02bbggrr

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header olectl.h
Библиотека OleAut32.lib
DLL OleAut32.dll