CreateHalftonePalette-Funktion (wingdi.h)

Artikel
03/04/2024

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

Syntax

HPALETTE CreateHalftonePalette(
  [in] HDC hdc
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

Rückgabewert

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

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Eine Anwendung sollte eine Halbtonpalette erstellen, wenn der Dehnungsmodus 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.

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

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