OleTranslateColor-Funktion (olectl.h)

  • Artikel

Konvertiert einen OLE_COLOR-Typ in eine COLORREF.

Syntax

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

Parameter

[in] clr

Die OLE-Farbe, die in eine COLORREF konvertiert werden soll.

[in] hpal

Palette, die als Grundlage für die Konvertierung verwendet wird.

[out] lpcolorref

Zeiger auf die Variable des Aufrufers, die das konvertierte COLORREF-Ergebnis empfängt. Dieser Parameter kann NULL sein, was angibt, dass der Aufrufer nur überprüfen möchte, ob eine konvertierte Farbe vorhanden ist.

Rückgabewert

Diese Funktion unterstützt die Standardrückgabewerte E_INVALIDARG und E_UNEXPECTED sowie den folgenden Wert.

Rückgabecode BESCHREIBUNG
S_OK
 Die Farbe wurde erfolgreich übersetzt.

Hinweise

In der folgenden Tabelle wird die Farbkonvertierung beschrieben.

OLE_COLOR hPal COLORREF
ungültig Undefined (E_INVALIDARG)
0x800000xx, xx ist kein gültiger GetSysColor-Index Undefined (E_INVALIDARG)
ungültig Undefined (E_INVALIDARG)
0x0100iiii, iiii ist kein gültiger Palettenindex gültige Palette Undefined (E_INVALIDARG)
0x800000xx, xx ist ein gültiger GetSysColor-Index NULL 0x00bbggrr
0x0100iiii, iiii ist ein gültiger Palettenindex NULL 0x0100iiii
0x02bbggrr (Palette relativ) NULL 0x02bbggrr
0x00bbggrr NULL 0x00bbggrr
0x800000xx, xx ist ein gültiger GetSysColor-Index gültige Palette 0x00bbggrr
0x0100iiii, iiii ist ein gültiger Palettenindex in hPal gültige Palette 0x0100iiii
0x02bbggrr (Palette relativ) gültige Palette 0x02bbggrr
0x00bbggrr gültige Palette 0x02bbggrr

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile olectl.h
Bibliothek OleAut32.lib
DLL OleAut32.dll