Crystal Vision
Virtual Cards
A group of controls is defined by the tag pair <controlgroup> and </controlgroup>. The same
tags are used at all levels.
VisionWeb uses a complex set of rules to optimise the presentation of groups of controls, but
typically different levels of <controlgroup> entries might appear as follows:
<card>
header section
<controlgroup>
this level appears as a new tab
<controlgroup>
this level appears as an accordion
<controlgroup>
this level appears as a sub-accordion
</controlgroup>
could have more sub-accordions in here
</controlgroup>
could have more accordions here
</controlgroup>
could have more tabs in here
</card>
Each <controlgroup> entry must have a name and can also have a label (maximum 10
characters) and optionally a 'labelfull', a longer label of up to 24 characters. These labels can
contain letters numbers and spaces. The label is what appears on the control interface,
graphical interfaces will use the 'labelfull' if it is present.
A
<
controlgroup
>
entry cannot be empty, it must contain one or more controls or additional
<controlgroup> entries.
The next step is to fill the <controlgroup> entries with the desired controls. The process
involves copying the relevant control definition from the XML file for the 'source' card – the
real card with the real control. This definition is pasted into the appropriate control group in
the virtual card XML and changed as follows:
•
The control ID is the number right at the start of the control definition. This must be a
unique value in the virtual card, no two controls can have the same ID number. If the
virtual card contains controls from more than one real card then two might have the
same ID, by chance or because they are the same control on different cards of the same
type. One way to ensure a unique control ID is to change the ID number to a new value
that goes up by one each time you add a control. Starting at 10 avoids overlapping with
the ID numbers in the header section. Make a note of the original control ID before you
overwrite it, you will need in the next few steps.
Indigo 1 User Manual R1.14
49
27 February 2020
