Funzione OleTranslateColor (olectl.h)

Articolo
03/13/2024

Converte un tipo di OLE_COLOR in un COLORREF.

Sintassi

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

Parametri

[in] clr

Colore OLE da convertire in colorREF.

[in] hpal

Tavolozza utilizzata come base per la conversione.

[out] lpcolorref

Puntatore alla variabile del chiamante che riceve il risultato COLORREF convertito. Questo parametro può essere NULL, che indica che il chiamante vuole solo verificare che esista un colore convertito.

Valore restituito

Questa funzione supporta i valori restituiti standard E_INVALIDARG e E_UNEXPECTED, nonché il valore seguente.

Codice restituito	Descrizione
S_OK	Il colore è stato tradotto correttamente.

Commenti

La tabella seguente descrive la conversione dei colori.

OLE_COLOR	hPal	COLORREF
non valido		Non definito (E_INVALIDARG)
0x800000xx, xx non è un indice GetSysColor valido		Non definito (E_INVALIDARG)
	non valido	Non definito (E_INVALIDARG)
0x0100iii, iiii non è un indice della tavolozza valido	tavolozza valida	Non definito (E_INVALIDARG)
0x800000xx, xx è un indice GetSysColor valido	NULL	0x00bbggrr
0x0100i, iiii è un indice di tavolozza valido	NULL	0x0100ii
0x02bbggrr (tavolozza relativa)	NULL	0x02bbggrr
0x00bbggrr	NULL	0x00bbggrr
0x800000xx, xx è un indice GetSysColor valido	tavolozza valida	0x00bbggrr
0x0100i, iiii è un indice di tavolozza valido in hPal	tavolozza valida	0x0100ii
0x02bbggrr (tavolozza relativa)	tavolozza valida	0x02bbggrr
0x00bbggrr	tavolozza valida	0x02bbggrr

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	olectl.h
Libreria	OleAut32.lib
DLL	OleAut32.dll

Condividi tramite