SetDIBColorTable-Funktion (wingdi.h)
Die SetDIBColorTable-Funktion legt RGB-Farbwerte (rot, grün, blau) in einem Bereich von Einträgen in der Farbtabelle des DIB fest, der derzeit in einem angegebenen Gerätekontext ausgewählt ist.
Syntax
UINT SetDIBColorTable(
[in] HDC hdc,
[in] UINT iStart,
[in] UINT cEntries,
[in] const RGBQUAD *prgbq
);
Parameter
[in] hdc
Ein Gerätekontext. In diesem Gerätekontext muss ein DIB ausgewählt werden.
[in] iStart
Ein nullbasierter Farbtabellenindex, der den ersten festzulegenden Farbtabelleneintrag angibt.
[in] cEntries
Die Anzahl der festzulegenden Farbtabelleneinträge.
[in] prgbq
Ein Zeiger auf ein Array von RGBQUAD-Strukturen , das neue Farbinformationen für die Farbtabelle des DIB enthält.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der Farbtabelleneinträge, die die Funktion festlegt.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Diese Funktion sollte aufgerufen werden, um die Farbtabelle für DIBs festzulegen, die 1, 4 oder 8 bpp verwenden. Das BitCount-Element der zugeordneten Bitmapinformationsheaderstruktur einer Bitmap.
BITMAPINFOHEADER-Struktur gibt die Anzahl der Bits pro Pixel an. Geräteunabhängige Bitmaps mit einem biBitCount-Wert größer als 8 verfügen nicht über eine Farbtabelle.
Das bV5BitCount-Element der zugeordneten BITMAPV5HEADER-Struktur einer Bitmap gibt die Anzahl der Bits pro Pixel an. Geräteunabhängige Bitmaps mit einem bV5BitCount-Wert größer als 8 verfügen nicht über eine Farbtabelle.
ICM: Es wird keine Farbverwaltung durchgeführt.
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 | wingdi.h (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |