PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Special cases
  • Caution
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
Adds a button into the thumbnail of the application in the taskbar. Used to give quickly access to some application features.
Important: This feature is available from Windows 7.
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)
Syntax
<Result> = SysThumbnailAddButton(<Icon to Display> , <Tooltip> , <Procedure Name> [, <Options>])
<Result>: Integer
  • Rank of the added button (between 1 and 7),
  • -1 if the addition failed (or if the bar is already full).
<Icon to Display>: Character string in Ansi or Unicode format (with quotes)
Path of the icon file to display. This file can be found on the disk or in the application library (WDL file).
<Tooltip>: Character string in Ansi or Unicode format (with quotes)
Text of the rollover tooltip of the button.
<Procedure Name>: Character string (with or without quotes)
Name of WLanguage procedure called during a click on the button.
No procedure will be started if this parameters corresponds to an empty string ("").
<Options>: Optional integer constant
Management mode of button. The available constants are as follows:
sysbtnActive
(Default value)
The button is active.
sysbtnCloseThumbnailA click performed on the button is used to close 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.
Remarks

Special cases

  • Only 7 buttons can be associated with a thumbnail.
  • 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.

Caution

This function must not be used in the declaration code of global variables of the window. Indeed, the window must be displayed to get the requested result.
If the button must be found in the thumbnail as soon as the window is opened, the function must be used in the initialization code of the window.
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
WD Jump lists Training (WINDEV): WD Jump lists
[ + ] JumpList in Windows 7

A JumpList is a menu accessible from the Start menu or from the application icon in the taskbar.
It is used to display the documents recently or frequently opened by the application. It is also used to display the specific tasks.

This example handles images and some operations are directly accessible from the JumpList.
Components
WINDEVReports and Queries wd230std.dll
Minimum required version
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment