GetDIBColorTable-Funktion (wingdi.h)

Artikel
03/04/2024

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