SetDIBColorTable-Funktion (wingdi.h)

Artikel
03/04/2024

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