# <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