OleTranslateColor, fonction (olectl.h)

Convertit un type OLE_COLOR en COLORREF.

Syntaxe

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

Paramètres

[in] clr

Couleur OLE à convertir en COLORREF.

[in] hpal

Palette utilisée comme base pour la conversion.

[out] lpcolorref

Pointeur vers la variable de l’appelant qui reçoit le résultat COLORREF converti. Ce paramètre peut être NULL, ce qui indique que l’appelant souhaite uniquement vérifier qu’une couleur convertie existe.

Valeur retournée

Cette fonction prend en charge les valeurs de retour standard E_INVALIDARG et E_UNEXPECTED, ainsi que la valeur suivante.

Code de retour	Description
S_OK	La couleur a été traduite avec succès.

Remarques

Le tableau suivant décrit la conversion de couleur.

OLE_COLOR	hPal	COLORREF
non valide		Non défini (E_INVALIDARG)
0x800000xx, xx n’est pas un index GetSysColor valide		Non défini (E_INVALIDARG)
	non valide	Non défini (E_INVALIDARG)
0x0100iiii, iiii n’est pas un index de palette valide	palette valide	Non défini (E_INVALIDARG)
0x800000xx, xx est un index GetSysColor valide	NULL	0x00bbggrr
0x0100iiii, iiii est un index de palette valide	NULL	0x0100iiii
0x02bbggrr (palette relative)	NULL	0x02bbggrr
0x00bbggrr	NULL	0x00bbggrr
0x800000xx, xx est un index GetSysColor valide	palette valide	0x00bbggrr
0x0100iiii, iiii est un index de palette valide dans hPal	palette valide	0x0100iiii
0x02bbggrr (palette relative)	palette valide	0x02bbggrr
0x00bbggrr	palette valide	0x02bbggrr

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	olectl.h
Bibliothèque	OleAut32.lib
DLL	OleAut32.dll