RealizePalette 関数 (wingdi.h)

RealizePalette 関数は、現在の論理パレットのパレット エントリをシステム パレットにマップします。

構文

UINT RealizePalette(
  [in] HDC hdc
);

パラメーター

[in] hdc

論理パレットが選択されているデバイス コンテキストへのハンドル。

戻り値

関数が成功した場合、戻り値はシステム パレットにマップされた論理パレット内のエントリの数です。

関数が失敗した場合、戻り値はGDI_ERROR。

解説

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

RealizePalette 関数は、指定したデバイス コンテキストに関連付けられているデバイスのパレットを変更します。 デバイス コンテキストがメモリ DC の場合、DC に選択されたビットマップのカラー テーブルが変更されます。 デバイス コンテキストが表示 DC の場合、そのデバイスの物理パレットが変更されます。

論理パレットは、色を集中的に使用するアプリケーションとシステムの間のバッファーであり、これらのアプリケーションは、他のウィンドウによって表示される色に干渉することなく、必要な数の色を使用できます。

アプリケーションのウィンドウにフォーカスがあり、 RealizePalette 関数を呼び出すと、システムは要求された色をできるだけ多く認識しようとします。 非アクティブなウィンドウを使用するアプリケーションでも同様です。

要件

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

関連項目

カラー関数

色の概要

CreatePalette

GetDeviceCaps

SelectPalette