Freigeben über


DIBINDEX-Makro (mmsystem.h)

Das DIBINDEX-Makro verwendet einen Index zu einem Eintrag in einer DIB-Farbtabelle und gibt einen COLORREF-Wert zurück, der die farbe angibt, die dem angegebenen Index zugeordnet ist. Eine Anwendung, die einen Gerätekontext verwendet, in dem ein DIB-Abschnitt ausgewählt ist, kann diesen Bezeichner anstelle eines expliziten roten, grünen, blauen (RGB)-Werts an GDI-Funktionen übergeben, die eine Farbe erwarten. Dadurch kann die Funktion die Farbe am angegebenen Farbtabellenindex verwenden.

Syntax

LONG DIBINDEX(
    WORD n
);

Die Parameter

n

Gibt einen Index für den Farbtabelleneintrag an, der die Farbe enthält, die für einen Grafikvorgang verwendet werden soll.

Rückgabewert

Typ: LONG

Der Rückgabewert ist ein Farbtabellenindexbezeichner in Form eines 32-Bit-COLORREF-Werts .

Bemerkungen

DIBINDEX indiziert Farben in einer DIB-Farbtabelle auf ähnliche Weise wie PALETTEINDEX Farben in einer logischen Palette indiziert.

DIBINDEX funktioniert auch mit 16-Bit-Bitmaps und Gerätekontexten (DCs).

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 2000 Professional [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows 2000 Server [nur Desktop-Apps]
Zielplattform Fenster
Überschrift mmsystem.h (enthalten Windows.h)

Siehe auch

COLORREF-

Farbmakros

Übersicht über Farben

PALETTEINDEX

RGB-