PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
SysIconAddImage (Function)
In French: SysIconeAjouteImage
Adds an icon that is superimposed over the icon of the application in the taskbar. This icon can be deleted by SysIconDeleteImage.
Important: This feature is available from Windows 7.
Example
// During the process, adds an hourglass icon over the icon of the application
SysIconAddImage("hourglass.ico")
HourGlass()

Long_process()

HourGlass(False)

// Delete the icon at the end of the process
SysIconDeleteImage()
Syntax
<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 the 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 an Icon variable.
    New in version 20
    Name of an Icon variable.
    Name of an 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 the 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
    Notes:
    • HQ display (High Quality) available.
    • Management of sheets in transparent BMP format (32 bits).
    New in version 22
    Notes:
    • HQ display (High Quality) available.
    • Management of sheets in transparent BMP format (32 bits).
    Notes:
    • 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)
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).
Remarks
  • Several successive calls to SysIconAddImage replace the icon that was previously displayed.
  • To delete the superimposed icon, 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
Components
WINDEVReports and Queries wd230std.dll
Minimum required version
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment