ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / System functions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
SysIconAddImage (Function)
In french: SysIconeAjouteImage
Adds an icon that overlays the application icon in the taskbar. This icon can be removed using SysIconDeleteImage.
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 or Icon variable
Corresponds to one of the following elements:
  • Path of the icon file to be displayed. This file can be found on the disk or in the application library (WDL file).
  • Name of a variable of type Icon.
If the icon is not 16x16, 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)
    Remark: 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)
    Remarks:
    • HQ display (High Quality) available.
    • Management of sheets in transparent BMP format (32 bits).
  • Cursors (*.cur)
  • Portable Document Format (*.pdf)
  • Scalable Vector Graphics (*.svg)
  • WINDEV images (generated by the image editor, *.WDPIC).
<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
  • Each call to SysIconAddImage replaces the icon displayed previously.
  • 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: wd290std.dll
Minimum version required
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 07/04/2023

Send a report | Local help