Vcl.Graphics.CreateMappedBmp
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 System::NativeInt OldColors_High, const System::Uitypes::TColor *NewColors, const System::NativeInt NewColors_High);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Vcl.Graphics.pas Vcl.Graphics.hpp |
Vcl.Graphics | Vcl.Graphics |
Beschreibung
Ändert die Farbtabelle in einem Bitmap.
Mit CreateMappedBmp kann die Farbtabelle einer Bitmap-Grafik selektiv geändert werden. Die Funktion ersetzt die in OldColors übergebenen Farben durch die Farben, die in NewColors angegeben werden. Sie gibt anschließend das Handle eines neuen geräteunabhängigen Bitmap (DDB) zurück, das die neue Farbtabelle verwendet. Handle ist das Handle des Bitmap, dessen Farbtabelle geändert werden soll. Geben Sie in C++ die Größe der Farbarrays mit OldColors_Size und NewColors_Size an. Übergeben Sie in den Parametern den Index des letzten Eintrags im jeweiligen Array.OldColors und NewColors sollten die gleiche Anzahl von Elementen enthalten.
Die Funktion erstellt ein neues Bitmap. Die Originalgrafik mit dem in Handle übergebenen Handle wird nicht geändert.
Anmerkung: CreateMappedBmp kann nicht für Bitmaps mit mehr als 256 Farben verwendet werden. Bei diesen Grafiken gibt die Funktion das Originalbitmap zurück.