SysIconModify (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Windows management functions

SysBatteryOptimBackground

SysCacheExternalStorage

SysChangeEnvironment

SysChangeScreenResolution

SysColor

SysColorRes

SysDetectLockedSession

SysDeviceInfo

SysDir

SysDirExternalStorage

SysIconDisplayTooltip

SysListScreenOrientation

SysListScreenResolution

SysListVideoCard

SysMemoryExternalStorage

SysRemovableExternalStorage

SysStatusExternalStorage

SysStatusStorageCard

SysTheme

SysThumbnailAddButton

SysThumbnailDeleteAll

SysThumbnailDeleteButton

SysThumbnailModifyButton

This content has been translated automatically. Click here to view the French version.

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SysIconModify (Function)

In french: SysIconeModifie

Modifies the icon file and/or the rollover message of an icon in the taskbar (bottom right corner of the screen). This icon was added into the taskbar by SysIconAdd.

Remark: The operating mode of the icon (popup menu, call to a procedure) is not modified.

On Smartphone, the icon cannot be associated with a rollover message. Therefore, SysIconModify can only be used to modify the icon file.

Example

// Modify the rollover message of the icon
// that was previously added into the taskbar
ResModifyIcon = SysIconModify("", "Comparison of sales")

Syntax

<Result> = SysIconModify(<Icon> [, <Rollover message>])

<Result>: Boolean

True if the icon was modified in the taskbar,
False otherwise.

<Icon>: Character string (between quotes) or Icon variable

Corresponds to one of the following elements:
Name and full (or relative) path of the icon file to add. A UNC path is allowed.
No relative path or UNC path can be used.
Versions 20 and later
Name of an Variable of type Icon.
New in version 20
Name of an Variable of type Icon.
Name of an Variable of type Icon.
If this parameter corresponds to an empty string (""), the icon file is not modified.

<Rollover message>: Optional character string (with quotes)

Message displayed when the icon is hovered by the mouse.
If this parameter is not specified or if it corresponds to an empty string (""), the rollover message is not modified.
This parameter is taken into account only if icon rollover is supported by the device used. This parameter is ignored on Smartphone.

Remarks

A single icon can be added into an application. You cannot add several ones.
SysIconAdd is used to add an icon.
SysIconDelete is used to delete the icon. The icon is automatically deleted when closing the application.

Component: wd260std.dll