希望提供其 bean 的显式信息的 bean 实现者可提供实现该 BeanInfo 接口的 BeanInfo 类和关于 bean 的方法、特性、事件等的显式信息。

bean 实现者不必提供显式信息的完全集。挑选要提供的信息, 其剩余的通过使用 bean 类的方法的低级反应和应用标准设计模式来自动分析获取。

获得提供许多不同信息作为各种 XyZDescriptor 类部分的机会。但不要担心，实际上仅需提供 各构造子必需的最小核心信息。

参见提供 BeanInfo 类某便捷“noop”基类的 SimpleBeanInfo 类，可覆盖用于返回显式 info 的特定位置。

关于 bean 的所有行为参见 Introspector 类。

接口 java.beans.BeanInfo

public interface BeanInfo

变量索引

ICON_COLOR_16x16

指示一个 16 x 16 色彩图标的 Constant。

ICON_COLOR_32x32

指示一个 32 x 32 色彩图标的 Constant。

ICON_MONO_16x16

指示一个 16 x 16 黑白图标的 Constant。

ICON_MONO_32x32

指示一个 32 x 32 黑白图标的 Constant。

方法索引

getAdditionalBeanInfo()

该方法允许一个 BeanInfo 对象返回可提供当前 bean 上附加信息的其它 BeanInfo 对 象的任意集合。

getBeanDescriptor()

getDefaultEventIndex()

一个 bean 可以有一个“缺省”事件，当使用 bean 时用户通常使用该事件。

getDefaultPropertyIndex()

一个 bean 可以有一个“缺省”特性，它是定制该 bean 的用户为了更新而开始通常选择的特性。

getEventSetDescriptors()

getIcon(int)

该方法返回一个图像实体，用于表示工具箱、工具条等的 bean 。

getMethodDescriptors()

getPropertyDescriptors()

变量

 public static final int ICON_COLOR_16x16

指示一个 16 x 16 色彩图标的 Constant 。

 public static final int ICON_COLOR_32x32

指示一个 32 x 32 色彩图标的 Constant 。

 public static final int ICON_MONO_16x16

指示一个 16 x 16 黑白图标的 Constant 。

 public static final int ICON_MONO_32x32

指示一个 32 x 32 黑白图标的Constant 。

方法

 public abstract BeanDescriptor getBeanDescriptor

()

返回值：

BeanDescriptor 提供关于 bean 的所有信息, 例如其 displayName 、 customizer 等。若信息应通过自动分析获得，则返回 null 。

 public abstract EventSetDescriptor[] 

getEventSetDescriptors()

返回值：

描述该 bean 所激发的事件种类的 EventSetDescriptors 数组。若信息应通过自动分析获 得，则可以返回 null 。

 public abstract int getDefaultEventIndex()

一个 bean 可以有一个“缺省”事件，当使用 bean 时用户通常使用该事件。

返回值：

getEventSetDescriptors 所返回的 EventSetDescriptor 数组中的缺省事件索引。

若 无缺省事件，则返回 -1。

 public abstract PropertyDescriptor[] 

getPropertyDescriptors()

返回值：

描述该 bean 支持的可编辑特性的 PropertyDescriptors 数组。若信息应通过自动分析获 得，则可以返回 null。

若某个特性被索引，则结果数组中它的输入项将属于 PropertyDescriptor 的 IndexedPropertyDescriptor 子类。getPropertyDescriptors 的客户能用“ instanceof”来检验某个给定的 PropertyDescriptor 是否为 IndexedPropertyDescriptor。

 public abstract int getDefaultPropertyIndex()

一个 bean 可以有一个“缺省”特性，它是定制该 bean 的用户为了更新而最经常选择的特性。

返回值：

getPropertyDescriptors 返回的 PropertyDescriptors 数组中的缺省特性索引。

若无 缺省特性，则返回 -1。

 public abstract MethodDescriptor[] 

getMethodDescriptors()

返回值：

描述该 bean 所支持的永久可见方法的 MethodDescriptors 数组。若信息应通过自动分析 获得，则可以返回 null。

 public abstract BeanInfo[] getAdditionalBeanInfo()

该方法允许一个 BeanInfo 对象返回提供当前 bean 上附加信息的其它 BeanInfo 对象的任意集合。

在不同 Beaninfo 对象提供的信息间若有冲突或重叠，则当前 BeanInfo 优先于 getAdditionalBeanInfo 对象,数组中后面的元素优先于前面的。

返回值：

BeanInfo 对象数组。可返回 null。

 public abstract Image getIcon(int 

iconKind)

该方法返回表示工具箱、工具条等中的 bean 。典型的图像图标是 GIF ，但将来可能包含其它格式。

Beans 不必提供图标并其且该方法可返回 null。

有四个可能的图标选项 (16x16 色、 32x32 色、 16x16 黑白色、32x32 黑白色) 。若选择某个 bean 仅支持单个图标，则建议支持 16x16 色。

建议图标有“透明”背景，以便能将其描绘到某个现存背景上。

参数：

iconKind - 请求图标种类。应为常量值 ICON_COLOR_16x16、 ICON_COLOR_32x32、 ICON_MONO_16x16 或 ICON_MONO_32x32 之一。

返回值：

表示请求图标的一个图像实体。若无合适图标可用，则返回 null。