Icon (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Various properties

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Icon (Property)

In french: Icone

The Icon property is used to:

Find out the icon displayed in the title bar of a window or a Dockable Panel control.
Change the icon displayed in the title bar of a window or a Dockable Panel control.

Example

// Find out the icon displayed in the "WIN_CustomerInput" window
ResIcon = WIN_CustomerInput.Icon

// Modify the icon displayed in the "WIN_CustomerInput" window

// By using a ".ico" file: 
WIN_CustomerInput.Icon = "MyIcon.ico"

// By using an Image control:
WIN_CustomerInput.Icon = dSaveImagePNG(iMG_Image1, inMemory)

Syntax

Retrieving the window icon Hide the details

<Result> = <Element used>.Icon

<Result>: Character string

Icon of the specified element. The icon name is returned without its path.

<Element used>: Control name or window name

Name of the window to be used.
Name of the Dockable Panel control to use.

Modifying the window icon Hide the details

<Element used>: Control name or window name

Name of the window to be used.
Name of the Dockable Panel control to use.

<New value>: Character string or Buffer variable

Corresponds to:
Name and path (full, relative or UNC) of new icon. This icon must be in ".ico" format.
Remarks:
If the path is not specified, the icon file will be searched for in the executable directory.
The current icon will be kept if the icon file does not exist.
Byte string returned by one of the following functions:
dSaveImageBMP.
dSaveImageGIF.
dSaveImagePNG.
dSaveImageJPEG.

Remarks

The icon of first project window is displayed:
- In the Windows taskbar.
- In the navigation window when pressing Alt + Tab.
The modification of an icon can only be performed on the opened windows. A WLanguage error occurs if the window is closed.