GetDIBColorTable-Funktion (wingdi.h)
Die GetDIBColorTable-Funktion ruft RGB-Farbwerte (rot, grün, blau) aus einem Bereich von Einträgen in der Farbtabelle der DIB-Abschnitts-Bitmap ab, die derzeit in einem angegebenen Gerätekontext ausgewählt ist.
Syntax
UINT GetDIBColorTable(
[in] HDC hdc,
[in] UINT iStart,
[in] UINT cEntries,
[out] RGBQUAD *prgbq
);
Parameter
[in] hdc
Ein Handle für einen Gerätekontext. In diesem Gerätekontext muss eine DIB-Abschnittsbit ausgewählt werden.
[in] iStart
Ein nullbasierter Farbtabellenindex, der den ersten abzurufenden Farbtabelleneintrag angibt.
[in] cEntries
Die Anzahl der abzurufenden Farbtabelleneinträge.
[out] prgbq
Ein Zeiger auf einen Puffer, der ein Array von RGBQUAD-Datenstrukturen empfängt , das Farbinformationen aus der DIB-Farbtabelle enthält. Der Puffer muss groß genug sein, um so viele RGBQUAD-Datenstrukturen wie der Wert von cEntries zu enthalten.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der Farbtabelleneinträge, die die Funktion abruft.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Die GetDIBColorTable-Funktion sollte aufgerufen werden, um die Farbtabelle für DIB-Abschnitts-Bitmaps abzurufen, die 1, 4 oder 8 bpp verwenden. Das biBitCount-Element einer bitmapINFOHEADER-Struktur gibt die Anzahl der Bits pro Pixel an. DIB-Abschnitts-Bitmaps mit einem biBitCount-Wert größer als acht verfügen nicht über eine Farbtabelle, aber sie verfügen über zugeordnete Farbmasken. Rufen Sie die GetObject-Funktion auf, um diese Farbmasken abzurufen.
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 (einschließlich Windows.h) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |