WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Stored procedures
SysIconAddImage (Function)
In french: SysIconeAjouteImage
Adds an icon that overlays the application icon in the taskbar. This icon can be deleted by SysIconDeleteImage.
Important: This feature is available from Windows 7.
// During the process, adds an hourglass icon over the icon of the application
// Delete the icon at the end of the process
<Result> = SysIconAddImage(<Image to display> [, <Explanation Text>])
<Result>: Boolean
  • True if the image was added over the application icon,
  • False otherwise.
<Image to display>: Character string (with quotes) or Icon variable
Corresponds to one of the following elements:
  • Path of icon file to display. This file can be found on the disk or in the application library (WDL file).
  • Versions 20 and later
    Name of Icon variable.
    New in version 20
    Name of Icon variable.
    Name of Icon variable.
If the icon used is not in 16x16 format, it will be automatically resized by Windows.
The following image formats are supported in Windows:
  • Bitmap (*.BMP)
  • Graphics Interchange Format (*.gif)
  • Joint Picture Experts Group (*.jpg ; *.jpeg)
  • Kodak Photo CD (*.pcd)
  • PaintBrush (*.pcx)
  • Adobe Photoshop Format (*.psd)
  • TrueVision TARGA (*.tga)
  • Tagged Image File Format (*.tif ; *.tiff)
    Note: the "tiled tiff" option of tiff 6.0 standard is not supported. In this case, we advise you to save the image in tiff 5.0 standard.
  • Portable Network Graphics (*.png)
  • Windows MetaFiles (*.emf ; *.wmf)
  • Icons (*.ico ; *.icw)
    Versions 22 and later
    • HQ display (High Quality) available.
    • Management of sheets in transparent BMP format (32 bits).
    New in version 22
    • HQ display (High Quality) available.
    • Management of sheets in transparent BMP format (32 bits).
    • HQ display (High Quality) available.
    • Management of sheets in transparent BMP format (32 bits).
  • Cursors (*.cur)
  • Portable Document Format (*.pdf)
  • Versions 15 and later
    Scalable Vector Graphics (*.svg)
    New in version 15
    Scalable Vector Graphics (*.svg)
    Scalable Vector Graphics (*.svg)
  • Versions 22 and later
    WINDEV images (generated by the image editor, *.WDPIC).
    New in version 22
    WINDEV images (generated by the image editor, *.WDPIC).
    WINDEV images (generated by the image editor, *.WDPIC).
Note: To manage the pdf and svg formats, GDIPLUS.DLL must be installed for the computers running Windows 2000 and earlier. For the later versions, this DLL is supplied with Windows. See GDI+ framework for more details.
<Explanation Text>: Optional character string (ANSI or Unicode)
Text associated with icon for accessibility reasons (for the applications intended to the low-sighted persons for example).
  • Several successive calls to SysIconAddImage replace the icon that was previously displayed.
  • To delete the icon overlay, use SysIconDeleteImage.
  • The taskbar must be configured to display the "Large icons" mode.
Related Examples:
The functions specific to Windows 7 Unit examples (WINDEV): The functions specific to Windows 7
[ + ] Using WLanguage functions specific to Windows 7:
- SysIconAddImage
- SysThumbnailAddButton
- SysThumbnailDeleteAll
Business / UI classification : Business Logic
Component : wd250std.dll
Minimum version required
  • Version 15
This page is also available for…
Click [Add] to post a comment