Vcl.Graphics.CreateMappedBmp

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

function CreateMappedBmp(Handle: HBITMAP; const OldColors, NewColors: array of TColor): HBITMAP;

C++

extern DELPHI_PACKAGE HBITMAP __fastcall CreateMappedBmp(HBITMAP Handle, const System::Uitypes::TColor *OldColors, const int OldColors_High, const System::Uitypes::TColor *NewColors, const int NewColors_High);

プロパティ

種類 可視性 ソース ユニット
function public
Vcl.Graphics.pas
Vcl.Graphics.hpp
Vcl.Graphics Vcl.Graphics

説明

ビットマップ中のカラーテーブルを変更します。

CreateMappedBmp 関数を呼び出すと,ビットマップのカラーマップを選択的に変更することができます。CreateMappedRes は,OldColors の色を NewColors の色に置換して,新しいデバイス依存のビットマップ(DDB)のハンドルを返します。Handle は,変更の対象となるビットマップのハンドルです。C++では,OldColors_Size および NewColors_Size 内のカラー配列のサイズを指定します。この値は,対応する配列内の最後のエントリのインデックスになります。OldColors の要素数と NewColors の要素数は一致していなければなりません。

CreateMappedBmp は,新しいビットマップを作成します。Handle パラメータで指定されたハンドルを持つ元のビットマップを変更することはありません。

メモ:  CreateMappedBmp は,256 色までのビットマップを対象に動作します。256 色より多くの色を使ったビットマップを対象とした場合,CreateMappedBmp は元のビットマップを返します。

関連項目