Freigeben über


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

Weitere Informationen

BITMAPINFOHEADER

Bitmapfunktionen

Übersicht über Bitmaps

CreateDIBSection

DIBSECTION

GetDIBColorTable

Getobject

RGBQUAD