Associating an image with an element in a TreeView control

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / TreeView control

Image associated with an element
Associating one or more images with an element
Image format

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

The TreeView control

Associating an image with an element in a TreeView control

Image associated with an element

Each element in a TreeVew control is preceded by an image. This image can be different depending on the state of the current element (or level). You can display an image:

when the level is expanded,
when the level is collapsed or is a leaf node.

Example of TreeView control in an WINDEV application:

Example of a collapsed level image:

Example of an expanded level image:

Note: You can also associate an identifier with an element. For more details, see Associating an identifier with an element.

Associating one or more images with an element

To associate one or more images with an element of a TreeView control, simply specify the name (and path, if necessary) of the desired image when using the following functions:


TreeAdd	Adds a "leaf" element (and all necessary nodes) into a TreeView control.
TreeInsert	Inserts a leaf into a TreeView control at a specific position.
TreeModify	Modifies an element (node or leaf) in a TreeView control.

These functions are also available in prefix syntax:


<TreeView>.Add	Adds a "leaf" element (and all necessary nodes) into a TreeView control.
<TreeView>.Insert	Inserts a leaf into a TreeView control at a specific position.
<TreeView>.Modify	Modifies an element (node or leaf) in a TreeView control.

Note: If no image is associated with an element in a TreeView control, the "Closed folder" (

) and "Open folder" (

) icons are used.

Image format

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 in TIFF 6.0 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).
New in version 2025
Images in WebP format (*.webp).

The following image formats are supported: GIF, JPEG, PNG or SVG (depending on the browser).

The images used can be:

image files.
items of a "Binary Memo" HFSQL data file containing an image.
drawings created with the drawing functions for List and Combo Box controls.

Only image files can be used. These files must be in the "<ProjectName>_WEB" directory. These images are not transformed when the page is saved. There is no need to use fWebDir to specify the image path. This path is relative to the "<ProjectName>_WEB" directory.

Remarks:

The specified image is proportionally resized to adapt to the height of the row in the TreeView control. The size of the images used should be set to 16x16 pixels (size of the small WINDEV icons).
Magenta areas in the images will be transparent at runtime.