Module java.desktop
Package java.beans

# Annotation Interface BeanProperty

@Documented @Target(METHOD) @Retention(RUNTIME) public @interface BeanProperty
An annotation used to specify some property-related information for the automatically generated `BeanInfo` classes. This annotation is not used if the annotated class has a corresponding user-defined `BeanInfo` class, which does not imply the automatic analysis. If both the read and the write methods of the property are annotated, then the read method annotation will have more priority and replace the write method annotation.

Since:
  9
See Also:
  - `BeanInfo.getPropertyDescriptors()`

## Optional Element Summary

Optional Elements
Modifier and Type
Optional Element
Description
`boolean`
`bound`
The value that indicates whether the annotated property can be a `bound` property or not.
`String`
`description`
The `short description` for the `descriptor` of the annotated property.
`String[]`
`enumerationValues`
The array of names for the public static fields that contains the valid values of the annotated property.
`boolean`
`expert`
The value that indicates whether the annotated property is an `expert` property or not.
`boolean`
`hidden`
The value that indicates whether the annotated property is a `hidden` property or not.
`boolean`
`preferred`
The value that indicates whether the annotated property is a `preferred` property or not.
`boolean`
`required`
The value that indicates whether the annotated property is a required property or not.
`boolean`
`visualUpdate`
The value that indicates whether the corresponding component is repainted after the annotated property got changed or not.

## Element Details

### bound

boolean bound
The value that indicates whether the annotated property can be a `bound` property or not. This value applies only to the beans that have the `propertyChange` event set.

Returns:
  `true` if the annotated property can be a bound property; `false` otherwise.

Default:
  `true`

### expert

boolean expert
The value that indicates whether the annotated property is an `expert` property or not.

Returns:
  `true` if the annotated property is an expert property; `false` otherwise.

Default:
  `false`

### hidden

boolean hidden
The value that indicates whether the annotated property is a `hidden` property or not.

Returns:
  `true` if the annotated property is a hidden property; `false` otherwise.

Default:
  `false`

### preferred

boolean preferred
The value that indicates whether the annotated property is a `preferred` property or not.

Returns:
  `true` if the annotated property is a preferred property; `false` otherwise.

Default:
  `false`

### required

boolean required
The value that indicates whether the annotated property is a required property or not.

Returns:
  `true` if the annotated property is a required property; `false` otherwise.

Default:
  `false`

### visualUpdate

boolean visualUpdate
The value that indicates whether the corresponding component is repainted after the annotated property got changed or not.

Returns:
  `true` if the corresponding component is repainted; `false` otherwise.

Default:
  `false`

### description

String description
The `short description` for the `descriptor` of the annotated property.

Returns:
  the property description, or an empty string if the description is not set.

Default:
  `""`

### enumerationValues

String[] enumerationValues
The array of names for the public static fields that contains the valid values of the annotated property. These names are used to generate the `enumerationValues` `feature attribute` that must contain the following items per each property value: a displayable name for the property value, the actual property value, and a Java code piece used for the code generator.

Returns:
  the names of the valid values of the annotated property, or an empty array if the names are not provided.

Default:
  `{}`