Caution

This is the documentation for the current development branch of the CometVisu. It is possible that some of the described features are not yet available in the current release.

Also there might be lots of errors in this documentation as some parts of the content have been translated by an online translation service.

The Group widget

Author: Christian Mayer
Available since: 0.8.0 (2012)

Description

A group can be used to group a couple of widgets and optionally surround them with a border or name the group.

Settings

For a general understanding of how the configuration files are structured and what elements and attributes are it is recommended to read this section first: Basics.

The behaviour and appearance of the Group widget can be influenced by using certain attributes and elements. The following tables show the allowed attributes and elements and their possible values. The screenshots show, how both can be edited in the editor.

Attributes underlined by ….. are mandatory, all the others are optional and be omitted.

Allowed attributes in the Group-element

Element	Attribute
	Name	Content	Description
group	name	string	Name/title of the group
	nowidget	true or false	Removes the frame borders inside the group (only in Metal Design)
	flavour	string	Selection of a display variant. See also Flavour.
	target	string	The name of the page, that should be called.
	align	left, right or center
	class	string	Add this value to the CSS class so that it can be formatted by a user provided style sheet.

../../../_images/en_config_widgets_group_index_editor_attributes.png — Attributes in the editor (simple view) [1]

Allowed child-elements and their attributes

All widgets and plugins are allowed in a group.

Examples

It is possible to manually edit the visu_config.xml and add an entry for the Group widget.

Caution

Make sure that you only use UTF-8 encoded characters by settings the encoding in your XML-editor to UTF-8 mode!

<group name="Example Group">
   <layout colspan="6"/>
   <text><label>Some Text</label></text>
   <switch>
     <layout colspan="3"/>
     <label>Switch</label>
     <address transform="DPT:1.001" mode="readwrite">0/0/0</address>
   </switch>
   <info format="%.1f °C">
     <layout colspan="3"/>
     <label>Temperature</label>
     <address transform="DPT:9.001">0/0/1</address>
   </info>
 </group>

<group nowidget="true">
   <layout colspan="6"/>
   <text><label>Some Text</label></text>
   <switch>
     <layout colspan="3"/>
     <label>Switch</label>
     <address transform="DPT:1.001" mode="readwrite">0/0/0</address>
   </switch>
   <info format="%.1f °C">
     <layout colspan="3"/>
     <label>Temperature</label>
     <address transform="DPT:9.001">0/0/1</address>
   </info>
 </group>

Footnotes