Vcl.Graphics.CreateMappedRes
Delphi
function CreateMappedRes(Instance: THandle; ResName: PChar; const OldColors, NewColors: array of TColor): HBITMAP;
C++
extern DELPHI_PACKAGE HBITMAP __fastcall CreateMappedRes(NativeUInt Instance, System::WideChar * ResName, const System::Uitypes::TColor *OldColors, const int OldColors_High, const System::Uitypes::TColor *NewColors, const int 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 einer Bitmap-Ressource.
Mit CreateMappedBmp kann die Farbtabelle einer Bitmap-Ressource 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. Geben Sie mit den Parametern Instance und ResName die Bitmap-Ressource an, deren 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, nicht die Anzahl der Elemente im jeweiligen Array. OldColors und NewColors sollten die gleiche Anzahl von Elementen enthalten.
Anmerkung: CreateMappedRes kann nicht für Bitmaps mit mehr als 256 Farben verwendet werden. Bei diesen Grafiken gibt die Funktion das Originalbitmap ohne Farbänderungen zurück.