Программирование: InitializeBitmapImageFromIcon

Прототип

function InitializeBitmapImageFromIcon(const BitmapImage: TBitmapImage; const IconFilename: String; const BkColor: TColor; const AscendingTrySizes: TArrayOfInteger): Boolean;

Описание

Выполняет инициализацию растрового изображения файла значка, указанного в параметре IconFilename, используя заданный цвет фона BkColor для прозрачных частей изображения.

Растровое изображение BitmapImage уже должно быть масштабировано и тогда функция загрузит наиболее подходящий под указанные в массиве размеры значок. После загрузки функция установит размеры растрового изображения согласно размерам значка.

Все значения в массиве AscendingTrySizes должны быть отсортированы от наименьшего размера к наибольшему.

Если в массиве не будет найдено соответствующее совпадение (например, потому что он пустой), в качестве размера будет использоваться минимальная ширина и высота растрового изображения.

Функция возвращает значение True, если значок может быть успешно загружен, в противном случае — False.

Пример

procedure InitializeWizard;
var
  Page: TWizardPage;
  BitmapImage: TBitmapImage;
begin
  Page := CreateCustomPage(wpWelcome, 'Test', 'Test');

  BitmapImage := TBitmapImage.Create(Page);
  
  with BitmapImage do begin
    Width := ScaleX(32);
    Height := ScaleY(32);
    Parent := Page.Surface;
  end;

  InitializeBitmapImageFromIcon(BitmapImage, 'MyProg.ico', clNone, [32, 48, 64]);   
end;

См. также:

InitializeBitmapImageFromStockIcon