• Subscript of added element,
• -1 if an error occurred.

Remark: The added element can be directly handled via its subscript. You can modify the properties of this element.

Name of TreeMap control to use.
If this parameter corresponds to an empty string (""), the control used will be the TreeMap control to which the current event belongs.

Path and caption of element to add. The path is used to organize the elements, to group them. The separator of different path elements can be:

• the "\" character. For example: "MyDirectory\MyFile".
• the "TAB" character. For example: "Desserts"+TAB+"Ice cream".

The element caption corresponds to the last path element. This name is displayed in the TreeMap control. This name can be modified by the Caption property.

Weight of element displayed in the TreeMap control.

Background color of element. This color can correspond to:

• an RGB color (returned by RGB),
• an HSL color (returned by HSL),
• a preset color (see the preset colors of WLanguage).

If this parameter is specified, its content will be displayed in a tooltip when the element is hovered by the mouse cursor. This parameter corresponds to an empty string by default.
If this parameter is not specified, the tooltip will automatically display the content of the <Element path> parameter.