<control-tag> Element

Specifies a Java control property. In source code the property will appear as a custom tag; in Design View it will appear in the Property Editor.

Syntax

<control-tag 
    name="propertyName" 
    multiple="true | false" 
    validator-class="packageName.ClassName" 
    allow-declaration-override="true | false" 
/>

Attributes

name

 

Specifies the name of this property.

Allowable values: Any string.

Use: Required

Type: xs:string.

Default value: None.

multiple

Specifies whether this property may occur multiple times.

Allowable values: true or false.

Use: Optional.

Type: xs:boolean.

Default value: false.

validator-class

Specifies the name of a class to use for validating attribute values.

Allowable values: A fully-qualfied class name.

Use: Optional.

Type: xs:string.

Default value: None.

allow-declaration-override

Specifies whether this property may be overridden by a control declaration. If you set allow-declaration-override to true, then a developer using the control can add an annotation to set this tag's value in the control's declaration (in, say, a JWS file). The annotation on the declaration will override a corresponding annotation in the control's JCX or JCS file.

Allowable values: true or false.

Use: Optional.

Type: xs:boolean.

Default value: true.

Type

This element contain a description, a list of attributes, and/or attribute groups.

Hierarchy

Parent: control-tags.

Children: description, attribute, and attribute-group.

Remarks

This element's attribute and/or attribute-group child elements define the property's attributes.

Related Topics

Control Property Schema Reference

Tutorial: Java Control