CreatePalette 関数 (wingdi.h)

CreatePalette 関数は論理パレットを作成します。

構文

HPALETTE CreatePalette(
  [in] const LOGPALETTE *plpal
);

パラメーター

[in] plpal

論理パレット内の色に関する情報を含む LOGPALETTE 構造体へのポインター。

戻り値

関数が成功した場合、戻り値は論理パレットへのハンドルです。

関数が失敗した場合は、返される値は NULL です。

解説

アプリケーションは、 GetDeviceCaps 関数を呼び出し、RASTERCAPS 定数を指定することで、デバイスがパレット操作をサポートしているかどうかを判断できます。

アプリケーションが論理パレットを作成したら、 SelectPalette 関数を呼び出すことによって、そのパレットをデバイス コンテキストに選択できます。 デバイス コンテキストに選択されたパレットは、 RealizePalette 関数を呼び出すことによって実現できます。

パレットが不要になったら、 DeleteObject 関数を呼び出して削除します。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wingdi.h (Windows.h を含む)
Library Gdi32.lib
[DLL] Gdi32.dll

関連項目

カラー関数

色の概要

DeleteObject

GetDeviceCaps

LOGPALETTE

RealizePalette

SelectPalette