_ICON
Jump to navigation
Jump to search
The _ICON statement uses an image handle from _LOADIMAGE for the program header and icon image in the OS.
Syntax
- _ICON [mainImageHandle&[, smallImageHandle&]]
Parameters
- mainImageHandle& is the LONG handle value of the OS icon and title bar image pre-loaded with _LOADIMAGE when used alone.
- smallImageHandle& is the LONG handle value of a different title bar image pre-loaded with _LOADIMAGE when used.
- No image handle designates use of the default QB64 icon or the embedded icon set by $EXEICON.
Description
- If no image handle is passed, the default QB64 icon will be used (all versions). If the $EXEICON metacommand is used, _ICON without an image handle uses the embedded icon from the binary (Windows only).
- Beginning with version 1.000, the following is considered:
- mainImageHandle& creates the image as the icon in the OS and the image in the program header (title bar).
- smallImageHandle& can be used for a different image in the program header bar.
- The header image will automatically be resized to fit the icon size of 16 X 16 if smaller or larger.
- Once the program's icon is set, the image handle can be discarded with _FREEIMAGE.
Errors
- Images used can be smaller or larger than 32 X 32 pixels, but image resolution may be affected.
- It is important to free unused or unneeded images with _FREEIMAGE to prevent memory overflow errors.
- In SCREEN 0 (default text mode) you need to specify 32-bit mode in _LOADIMAGE to load images.
Availability
v0.800
all
yes
yes
yes
Examples
Example 1: Setting the program icon using a 32-bit image in SCREEN 0 (the default screen mode).
i& =_LOADIMAGE("RDSWU16.BMP", 32) '<<<<<<< use your image file name here IF i& < -1 THEN _ICON i& _FREEIMAGE i& ' release image handle after setting icon END IF |
- Note: _ICON images can be freed if the SCREEN mode stays the same. Freed image handles can on longer be referenced.
See also
- _TITLE
- _LOADIMAGE, _SAVEIMAGE
- $EXEICON
- Creating Icon Bitmaps
- Bitmaps, Icons and Cursors
- Icon Extraction