extract-icon-from-file

Arguments: filename &optional (icon-number 0)size

Returns an icon handle, which can be used as the icon of a window, the value of a static-picture control, or the title of a picture-button control.

The arguments are:

• filename, which must be a string indicating a file with a .ico, .dll, or .exe extension; an icon is loaded from this file.
• icon-number, which is used for files containing multiple icons; its value should be a non-negative integer indicating the index of the icon to load, where zero indicates the first icon in the file; defaults to zero.
• size, which is a keyword or nil that specifies whether to extract a large or small icon. If :large, then a large icon is returned if the file contains one, and otherwise nil is returned. If :small, then a small icon is returned if the file contains one, and otherwise nil is returned. If nil (the default), then a large icon is returned if the file contains one, and otherwise a small icon is returned.

  A note about small icons in Windows: If an icon file in Windows contains only a small icon, and the size argument is nil, then the small icon will be returned, but will be stretched to the large icon size. Therefore, to extract a small icon at its natural size in Windows, you must pass size as :small.

See cg-icons.htm.

Copyright (c) 1998-2006, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 7.0. The object described on this page has been modified in the 7.0 release; see the Release Notes.
Created 2005.9.20.