The XML descriptor for a custom component defines PARAMETER elements that render text fields, checkboxes, and other UI controls. There are several styling attributes in the PARAMETER elements that can position, group, and label the Component View.
|A Component Styled with GROUP and LABEL Elements|
The GROUP attribute can be added to a PARAMETER element to provide a border and a label for a set of related controls. Give the same GROUP name to the PARAMETER names.
A LABEL PARAMETER can be added to the XML descriptor to add explanatory text or an additional label to a UI control. Additionally, the LABEL can include a COLOR attribute. The COLOR attribute is an RGB value in decimal, separated by a semi-colon. "255;0;0" is red.
NUM_ROW is an attribute added to a PARAMETER that will position the UI control in the Component View. More than one PARAMETER can have the same NUM_ROW. In that case, the PARAMETER will render UI controls on the same row. In the above screenshot, PARAMETER P1 has a NUM_ROW of 1, the label has a NUM_ROW of 2, and P2 has a NUM_ROW of 3.
The following screenshot shows an XML descriptor fragment configuring several parameters.
|XML Descriptor with Grouping, Positioning, and an Extra Label|
MESSAGE.NAME=Fill this in for additional configuration
If you have a lot of UI controls in the Component View, you can arrange the controls in a bordered and labeled box. Labels -- in addition to those associated with the controls themselves -- can be added too.