Freigeben über


CreateHalftonePalette-Funktion (wingdi.h)

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

Weitere Informationen

Farbfunktionen

Übersicht über Farben

DeleteObject

RealizePalette

SelectPalette

SetStretchBltMode

StretchBlt

StretchDIBits