set-exe-icons-nt

Arguments: existing-exe icon-name icon-file

This function is useful for replacing the application icon in an executable file for delivery. It modifies existing-exe to replace the embedded icon resource whose name is icon-name with the icon from icon-file.

existing-exe should be a pathname or path namestring that specifies the .exe executable file whose application icon is to be replaced.

icon-name should be the name of the icon resource to be replaced. In an Allegro CL executable file (either a development lisp or a generated application), the application icon is named "ACLICON". This is the icon that will appear in the Windows taskbar and alt-tab window when the application is running, and in the File Explorer and Start Menu to represent the .exe file.

icon-file should be a pathname or path namestring that specifies a .ico icon file. Any valid .ico file should work (unlike with set-exe-icons). Generally it's best if the .ico file contains at least two images for the common 32 by 32 and 16 by 16 sizes, so that Windows doesn't need to interpolate pixels.

The following example would replace the Franz icon in myapp.exe with the custom icon defined in myicon.ico.

(win:set-exe-icons-nt "c:/foo/myapp.exe"
                      "ACLICON" "c:/foo/myicon.ico")

See the description of the icon-file keyword argument to generate-application, described in delivery.htm for more information on setting the icon for an application on Windows. Either this function of the related win:set-exe-icons function (as appropriate for the operating system) will be called. See also win:set-application-icon.

Copyright (c) 1998-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.