_ICON

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.840

• 

  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

---

Navigation: Main Page with Articles and Tutorials Keyword Reference - Alphabetical Keyword Reference - By usage Report a broken link