Fungsi OleTranslateColor (olectl.h)

Artikel
03/13/2024

Mengonversi jenis OLE_COLOR menjadi COLORREF.

Sintaks

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

Parameter

[in] clr

Warna OLE yang akan dikonversi menjadi COLORREF.

[in] hpal

Palet digunakan sebagai dasar untuk konversi.

[out] lpcolorref

Arahkan ke variabel penelepon yang menerima hasil COLORREF yang dikonversi. Parameter ini bisa NULL, menunjukkan bahwa pemanggil hanya ingin memverifikasi bahwa ada warna yang dikonversi.

Nilai kembali

Fungsi ini mendukung nilai pengembalian standar E_INVALIDARG dan E_UNEXPECTED, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Warna berhasil diterjemahkan.

Keterangan

Tabel berikut ini menjelaskan konversi warna.

OLE_COLOR	hPal	COLORREF
invalid		Tidak terdefinis (E_INVALIDARG)
0x800000xx, xx bukan indeks GetSysColor yang valid		Tidak terdefinis (E_INVALIDARG)
	invalid	Tidak terdefinis (E_INVALIDARG)
0x0100iiii, iiii bukan indeks palet yang valid	palet yang valid	Tidak terdefinis (E_INVALIDARG)
0x800000xx, xx adalah indeks GetSysColor yang valid	NULL	0x00bbggrr
0x0100iiii, iiii adalah indeks palet yang valid	NULL	0x0100iiiii
0x02bbggrr (palet relatif)	NULL	0x02bbggrr
0x00bbggrr	NULL	0x00bbggrr
0x800000xx, xx adalah indeks GetSysColor yang valid	palet yang valid	0x00bbggrr
0x0100iiii, iiii adalah indeks palet yang valid di hPal	palet yang valid	0x0100iiiii
0x02bbggrr (palet relatif)	palet yang valid	0x02bbggrr
0x00bbggrr	palet yang valid	0x02bbggrr

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	olectl.h
Pustaka	OleAut32.lib
DLL	OleAut32.dll

Bagikan melalui