SysIconModify (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Functions for Windows management

SysCacheExternalStorage

SysChangeEnvironment

SysChangeScreenResolution

SysColor

SysColorRes

SysDetectLockedSession

SysDeviceInfo

SysDir

SysDirExternalStorage

SysIconDisplayTooltip

SysListScreenOrientation

SysListScreenResolution

SysListVideoCard

SysMemoryExternalStorage

SysRemovableExternalStorage

SysStatusExternalStorage

SysStatusStorageCard

SysTheme

SysThumbnailAddButton

SysThumbnailDeleteAll

SysThumbnailDeleteButton

SysThumbnailModifyButton

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.

Note: 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 Icon variable.
New in version 20
Name of an Icon variable.
Name of an Icon variable.
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 : wd240std.dll