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
Modifies one of the buttons found on the application thumbnail in the taskbar.
Example
// Initialize a multimedia reader
SysThumbnailAddButton("reading.ico", "Reading", Reading)
SysThumbnailAddButton("pause.ico", "Pause", Pause, sysbtnGrayed)
SysThumbnailAddButton("stop.ico", "Stop", "", sysbtnGrayed)
SysThumbnailAddButton(CompleteDir(fExeDir()) + "close.gif", "Close", "", sysbtnCloseThumbnail)

// Modify a multimedia reader
SysThumbnailModifyButton(1, "fastReading.ico", "Reading", Reading)
Syntax
<Result> = SysThumbnailModifyButton(<Button number> , <Image to display> [, <Tooltip> [, <WLanguage procedure> [, <Options>]]])
<Result>: Boolean
  • True if the modification was performed,
  • False otherwise.
<Button number>: Integer
Rank of the button to modify (included between 1 and 7). When adding a button, SysThumbnailAddButton returns the rank of the added button.
<Image to display>: Ansi or Unicode character string
Path of the icon file to be displayed. This file can be found on the disk or in the application library (WDL file). If this parameter is not specified, the icon will not be modified.
Remarks:
  • 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).
<Tooltip>: Optional character string in Ansi or Unicode format
Text of the rollover tooltip of the button.
If this parameter is not specified, the text of the tooltip is not modified.
If this parameter corresponds to an empty string (""), the previous tooltip will be erased.
<WLanguage procedure>: Name of optional procedure
Name of WLanguage procedure called during a click on the button.
No procedure will be started if this parameters corresponds to an empty string ("").
If this parameter is not specified or if it is equal to Null, the name of the procedure will not be modified.
<Options>: Optional Integer constant
Management mode of button. The available constants are as follows:
sysbtnActive
(Default value)
The button is active.
sysbtnCloseThumbnailClicking the button closes the thumbnail of the application.
sysbtnGrayedThe button is grayed.
sysbtnInactiveThe button cannot be clicked (this constant can be used only when the button is used as notification icon).
sysbtnInvisibleThe button is invisible (its location is empty in the button bar).
sysbtnNoBackgroundOnly the button icon is drawn (not the button border). This constant can be used when the icon contains the border drawing.

If this parameter is not specified, the options remain identical to the ones defined by SysThumbnailAddButton.
Remarks
Only 7 buttons can be associated with a thumbnail.
Component: wd290std.dll
Minimum version required
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help