PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
This content has been translated automatically. Click here to view the French version.
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 deleted by 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> [, <Explanatory text>])
<Result>: Boolean
  • True if the image was added over the application icon,
  • False otherwise.
<Image to display>: String or Variable of type Icon
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 a variable of type Icon.
    New in version 20
    Name of a variable of type Icon.
    Name of a variable of type Icon.
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)
    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)
    Versions 22 and later
    Remarks:
    • HQ display (High Quality) available.
    • Management of sheets in transparent BMP format (32 bits).
    New in version 22
    Remarks:
    • HQ display (High Quality) available.
    • Management of sheets in transparent BMP format (32 bits).
    Remarks:
    • 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).
<Explanatory 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 function SysIconAddImage each replace the previously displayed Icon.
  • 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: wd270std.dll
Minimum version required
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment