Fungsi OleTranslateColor (olectl.h)

  • Artikel

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