CreateHalftonePalette 関数は、指定されたデバイス コンテキスト (DC) のハーフトーン パレットを作成します。
Syntax
HPALETTE CreateHalftonePalette(
[in] HDC hdc
);
Parameters
[in] hdc
デバイス コンテキストへのハンドル。
値を返す
関数が成功した場合、戻り値は論理ハーフトーン パレットへのハンドルです。
関数が失敗した場合、戻り値は 0 です。
Remarks
デバイス コンテキストのストレッチ モードが HALFTONE に設定されている場合、アプリケーションはハーフトーン パレットを作成する必要があります。 次に、CreateHalftonePalette によって返される論理ハーフトーン パレットを選択し、StretchBlt または StretchDIBits 関数が呼び出される前にデバイス コンテキストに認識する必要があります。
ハーフトーン パレットには、20 個の静的なシステム カラーに加えて、デバイスに依存しない色のセット (6x6 x 6 RGB カラー キューブと追加の灰色の網掛け) が含まれており、イメージのディザリング時に幅広い色を近似するように選択されます。 正確なカラー エントリは実装の詳細であり、デバイスまたはWindowsバージョン間で同一であるとは限りません。アプリケーションは、特定のパレット値や特定のディザリング アルゴリズムに依存しないでください。 実行時にエントリを検査するには、返されたパレット ハンドルで GetPaletteEntries を呼び出します。
パレットが不要になったら、 DeleteObject 関数を呼び出して削除します。
必要条件
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム | ウィンドウズ |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| DLL | Gdi32.dll |