OleTranslateColor-Funktion (olectl.h)
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 |
|---|---|
|
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 |