CreateHalftonePalette-Funktion (wingdi.h)

Die CreateHalftonePalette-Funktion erstellt eine Halbtonpalette für den angegebenen Gerätekontext (DC).

Syntax

HPALETTE CreateHalftonePalette(
  [in] HDC hdc
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

Zurückgegebener Wert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für eine logische Halbtonpalette.

Wenn die Funktion fehlschlägt, ist der Rückgabewert Null.

Remarks

Eine Anwendung sollte eine Halbtonpalette erstellen, wenn der Stretchmodus eines Gerätekontexts auf HALFTONE festgelegt ist. Die von CreateHalftonePalette zurückgegebene logische Halbtonpalette sollte dann ausgewählt und im Gerätekontext realisiert werden, bevor die StretchBlt - oder StretchDIBits-Funktion aufgerufen wird.

Die Halbtonpalette enthält die 20 statischen Systemfarben sowie einen geräteunabhängigen Satz von Farben (6x6x6 RGB-Farbwürfel und zusätzliche graue Schattierungen), die ausgewählt werden, um eine breite Palette von Farben anzunähern, wenn ein Bild gefächert wird. Die genauen Farbeinträge sind ein Implementierungsdetail und sind nicht garantiert auf allen Geräten oder Windows Versionen identisch. Anwendungen sollten nicht von bestimmten Palettenwerten oder einem bestimmten Ditheringalgorithmus abhängen. Um die Einträge zur Laufzeit zu prüfen, rufen Sie GetPaletteEntries auf dem zurückgegebenen Palettenhandle auf.

Wenn Sie die Palette nicht mehr benötigen, rufen Sie die DeleteObject-Funktion auf, um sie zu löschen.

Anforderungen

Siehe auch

Farbfunktionen

Übersicht über Farben

DeleteObject

GetPaletteEntries

RealizePalette

SelectPalette

SetStretchBltMode

StretchBlt

StretchDIBits