Associating an image with the elements of a TreeView control

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

Image associated with an element
Associating one or more images with an element
Format of images

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

The TreeView control

Associating an image with the elements of a TreeView control

Image associated with an element

Each element found in a TreeVew control is preceded by an image. This image can differ according to the status of the current element (or level). You can display an image:

when the level is expanded,
when the level is collapsed (or when the level corresponds to a leaf).

Example of TreeView control in a WINDEV application::

Image associated with the collapsed level: for example: Image of collapsed level

Image associated with the expanded level: for example: Image of expanded level

Remark: You also have the ability to 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, all you have to do is specify the name (and the path if necessary) of the image in the following programming 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.

Remark: If no specific image is associated with the elements of a TreeView control, the "closed folder" icon (

) and the "opened folder" icon ( Open folder

) are used.

Format of images

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)
Remark: the "tiled tiff" option of 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)
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).

The recognized image formats are as follows: GIF, JPEG, PNG or SVG (depending on the browsers).

The images used can be:

image files.
items of a "Binary Memo" HFSQL data file containing an image.
drawings created by the functions for drawing in the list boxes and combo boxes.

Only the image files can be used. These files must be found 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 reduced: the height of the image corresponds 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).
The magenta color found in the images is considered as being transparent at run time.